ホーム › Devices.Fax › PFAXREGISTERSERVICEPROVIDERW

PFAXREGISTERSERVICEPROVIDERW

コールバック

シグネチャ

BOOL PFAXREGISTERSERVICEPROVIDERW(
    LPWSTR DeviceProvider,
    LPWSTR FriendlyName,
    LPWSTR ImageName,
    LPWSTR TspName
);

パラメーター

フィールド	型	説明
DeviceProvider	LPWSTR	登録するファックスサービスプロバイダー DLL の内部名を指定する、定数の null 終端 Unicode 文字列へのポインターです。GUID など、一意の文字列を指定してください。
FriendlyName	LPWSTR	ファックスサービスプロバイダー DLL に関連付ける、定数の null 終端 Unicode 文字列へのポインターです。これは表示に適した、ファックスサービスプロバイダーのわかりやすい名前です。
ImageName	LPWSTR	ファックスサービスプロバイダー DLL の完全なパスとファイル名を指定する、定数の null 終端 Unicode 文字列へのポインターです。パスには、%SYSTEMDRIVE% や %SYSTEMROOT% などの有効な環境変数を含めることができます。
TspName	LPWSTR	ファックスサービスプロバイダーのデバイスに関連付けられているテレフォニーサービスプロバイダーの名前を指定する、定数の null 終端 Unicode 文字列へのポインターです。仮想ファックスデバイスの場合は、空の文字列を使用します。

公式ドキュメント

FaxRegisterServiceProvider 関数は、ファックスサービスプロバイダー DLL をファックスサービスに登録します。この関数は、ファックスサービスの再起動時に新しいファックスサービスプロバイダー DLL を照会して使用するように、ファックスサービスのレジストリを構成します。

戻り値

型: BOOL

関数が成功すると、戻り値は 0 以外の値になります。

関数が失敗すると、戻り値は 0 になります。拡張エラー情報を取得するには、GetLastError を呼び出します。GetLastError は次のいずれかのエラーを返すことがあります。

戻り値	説明
ERROR_INVALID_PARAMETER	FaxRegisterServiceProvider 関数のパラメーターのうち、少なくとも 1 つが NULL です。

解説(Remarks)

FaxRegisterServiceProvider 関数はレジストリを変更するため、ユーザー (通常はシステム管理者) は HKEY_LOCAL_MACHINE レジストリキーへの書き込みアクセス権を持っている必要があります。

FaxRegisterServiceProvider 関数のすべてのパラメーターは必須です。

ファックスサービスプロバイダーは、ローカルにインストールすることを推奨します。ファックスサービスプロバイダー DLL のローカルインストールルーチンは、レジストリに直接アクセスする代わりに FaxRegisterServiceProvider を呼び出すことができます。ファックスサービスにローカルで登録するために必要な手順の詳細については、ファックスサービスプロバイダーの登録を参照してください。

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