PFAX_SEND_CALLBACK

コールバック

シグネチャ

BOOL PFAX_SEND_CALLBACK(
    HANDLE FaxHandle,
    DWORD CallHandle,
    DWORD Reserved1,
    DWORD Reserved2
);

パラメーター

フィールド	型	説明
FaxHandle	HANDLE	FaxDevStartJob 関数が返したファクスハンドルを指定します。
CallHandle	DWORD	TAPI 2.x の LINE_CALLSTATE メッセージが返した呼び出しハンドルを指定します。
Reserved1	DWORD	このパラメーターは、Microsoft が将来使用するために予約されています。0 に設定する必要があります。
Reserved2	DWORD	このパラメーターは、Microsoft が将来使用するために予約されています。0 に設定する必要があります。

公式ドキュメント

FaxSendCallback 関数は、送信ファクスの呼び出しが進行中であることをファクスサービスに通知するために、ファクスサービスプロバイダー (FSP) が呼び出すアプリケーション定義またはライブラリ定義のコールバック関数です。

PFAX_SEND_CALLBACK データ型は、FaxSendCallback 関数へのポインターです。FaxSendCallback は、アプリケーション定義またはライブラリ定義の関数名のプレースホルダーです。

戻り値

Type: BOOL

ファクスサービスは、実行中のファクス操作を継続することを示すために TRUE を返します。

ファクスサービスは、実行中のファクス操作を終了することを示すために FALSE を返します。拡張エラー情報を取得するには、GetLastError を呼び出します。

解説(Remarks)

FaxSendCallback コールバック関数は、TAPI が割り当てた CallHandle をファクスサービスに渡します。このハンドルは TAPI のメッセージルーティングに必要です。FSP が FaxSendCallback を呼び出さない場合、以降のすべての呼び出しイベントを受け取れなくなります。

仮想 FSP では FaxSendCallback 関数は必要ありません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)