ホーム › Devices.Fax › PFAX_EXT_UNREGISTER_FOR_EVENTS

PFAX_EXT_UNREGISTER_FOR_EVENTS

コールバック

シグネチャ

DWORD PFAX_EXT_UNREGISTER_FOR_EVENTS(
    HANDLE param0
);

パラメーター

フィールド	型
param0	HANDLE

公式ドキュメント

FaxExtUnregisterForEvents コールバック関数は、特定のデバイスおよび GUID に関連する構成データの変更についての通知に対する FAX 拡張 DLL の登録を解除します。

戻り値

型: DWORD

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は WinError.h で定義されている 0 以外のエラーコードです。FORMAT_MESSAGE_FROM_SYSTEM フラグを指定して Win32 の FormatMessage 関数を呼び出すと、エラーの一般的な説明を取得できます。

FaxExtUnregisterForEvents 関数は、次のエラーコードを返すことがあります。

戻り値	説明
ERROR_SUCCESS	登録解除の処理は成功しました。
ERROR_NOT_FOUND	hNotification パラメーターで指定された登録ハンドルが見つかりませんでした。
ERROR_INVALID_PARAMETER	hNotification パラメーターが無効です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するのに十分なメモリーがありません。
ERROR_GEN_FAILURE	FAX サーバーで内部エラーが発生したため、データにアクセスできません。
ERROR_SHUTDOWN_IN_PROGRESS	サーバーはシャットダウン中です。
ERROR_BUSY	サーバーは、データ変更に関する通知を送信している間は、通知の要求を処理できません。しばらく時間を置いてからこの関数を呼び出してください。

解説(Remarks)

FAX 拡張機能がこの FAX サービスのコールバック関数を呼び出すときは、FaxExtInitializeConfig 関数をサービスが呼び出した際に FAX サービスが公開した関数ポインターを使用する必要があります。

FAX 拡張機能は、FaxExtUnregisterForEvents 関数を呼び出すことで、デバイスの構成データの変更に関する通知の受信を停止できます。拡張機能は、FAX サービスのコールバック関数 FaxExtRegisterForEvents を呼び出して通知を登録します。

FAX サービスは、FaxExtUnregisterForEvents コールバック関数へのポインターを、FaxExtInitializeConfig 関数を呼び出すときに渡します。PFAX_EXT_UNREGISTER_FOR_EVENTS データ型は、FaxExtUnregisterForEvents 関数へのポインターです。

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