PFAX_EXT_SET_DATA

コールバック

シグネチャ

DWORD PFAX_EXT_SET_DATA(
    HINSTANCE param0,
    DWORD param1,
    FAX_ENUM_DEVICE_ID_SOURCE param2,
    LPWSTR param3,
    BYTE* param4,
    DWORD param5
);

パラメーター

フィールド	型
param0	HINSTANCE
param1	DWORD
param2	FAX_ENUM_DEVICE_ID_SOURCE
param3	LPWSTR
param4	BYTE*
param5	DWORD

公式ドキュメント

FaxExtSetData 関数は、特定のデバイスと GUID に対する構成データを設定します。

戻り値

型: DWORD

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

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

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

戻り値	説明
ERROR_SUCCESS	構成データが正常に保存されました。
ERROR_INVALID_PARAMETER	関数に渡されたパラメーターのうち、少なくとも 1 つが無効です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するのに十分なメモリがありません。
ERROR_FILE_NOT_FOUND	指定されたデバイス ID を持つデバイスが見つかりませんでした。
ERROR_GEN_FAILURE	FAX サーバーで内部エラーが発生したため、データにアクセスできません。
ERROR_SHUTDOWN_IN_PROGRESS	サーバーがシャットダウン中です。

解説(Remarks)

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

セキュリティ要件: この関数を呼び出すには、呼び出し元がサーバーの構成データを管理するアクセス権を持っている必要があります。

FaxExtGetData 関数を呼び出すと、グローバルな構成データ、または特定のデバイスと GUID に対する構成データを取得できます。

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

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