PFAXROUTEENUMFILES

コールバック

シグネチャ

BOOL PFAXROUTEENUMFILES(
    DWORD JobId,
    GUID* Guid,
    PFAXROUTEENUMFILE FileEnumerator,
    void* Context
);

パラメーター

フィールド	型	説明
JobId	DWORD	ファクスドキュメントを受信したファクスジョブを識別する一意の番号を指定します。
Guid	GUID*	ファクスルーティングメソッドの GUID を格納する、null で終わる Unicode 文字列へのポインター。
FileEnumerator	PFAXROUTEENUMFILE	ファクスルーティング拡張機能によって定義された FaxRouteEnumFile コールバック関数へのポインター。FaxRouteEnumFile は、受信したファクスドキュメントに関連付けられたファクスファイルリスト内のファイル名を受け取ります。
Context	void*	FaxRouteEnumFiles が FaxRouteEnumFile 関数に渡す、拡張機能定義の値へのポインター。ファクスルーティングメソッドがこの値を定義できます。

公式ドキュメント

ファクスルーティングメソッドは、受信したファクスドキュメントに関連付けられたファクスファイルリスト内のファイルを列挙するために、FaxRouteEnumFiles コールバック関数を呼び出します。

FaxRoutingMethod は、FaxRouteEnumFiles を呼び出す場合、FaxRouteEnumFile コールバック関数へのポインターを渡します。

戻り値

Type: BOOL

関数が成功した場合、戻り値は 0 以外の値です。

関数が失敗した場合、戻り値は 0 です。拡張エラー情報を取得するには、ファクスサービスが GetLastError を呼び出します。

解説(Remarks)

ファクスサービスは、FaxRouteInitialize 関数を呼び出すときに、FaxRouteEnumFiles コールバック関数へのポインターを渡します。サービスは、このポインターを FAX_ROUTE_CALLBACKROUTINES 構造体に格納して渡します。

PFAXROUTEENUMFILES データ型は、FaxRouteEnumFiles 関数へのポインターを定義します。

ファクスルーティング拡張機能 DLL は、FileEnumerator パラメーターで指定された FaxRouteEnumFile 関数を提供する必要があります。ファクスサービスは、ファクスルーティングメソッドのファクスファイルリスト内のファイルを列挙するために FaxRouteEnumFile を呼び出します。ファクスサービスは、ファクスファイルリスト内のファイルごとに 1 回ずつ FaxRouteEnumFile を呼び出します。

詳細については、「Fax File Lists」を参照してください。

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