ホーム › Networking.WinSock › LPWPUGETPROVIDERPATH

LPWPUGETPROVIDERPATH

コールバック

シグネチャ

INT LPWPUGETPROVIDERPATH(
    GUID* lpProviderId,
    LPWSTR lpszProviderDllPath,
    INT* lpProviderDllPathLen,
    INT* lpErrno
);

パラメーター

フィールド	型	説明
lpProviderId	GUID*	プロバイダーのローカルで一意な識別子です。これは WSCEnumProtocols を使用して取得した値である必要があります。
lpszProviderDllPath	LPWSTR	プロバイダー DLL のパスを示す文字列が格納されたバッファーへのポインターです。このパスは null 終端の文字列で、埋め込まれた環境文字列 (%SystemRoot% など) は展開されていません。
lpProviderDllPathLen	INT*	lpszProviderDllPath が指すバッファーのサイズ (文字数単位) です。
lpErrno	INT*	エラーコードへのポインターです。

公式ドキュメント

WPUGetProviderPath 関数は、指定したプロバイダーの DLL パスを取得します。

戻り値

エラーが発生しなかった場合、 WPUGetProviderPath は 0 を返します。それ以外の場合は SOCKET_ERROR を返し、具体的なエラーコードは lpErrno で取得できます。

エラーコード	意味
WSAEINVAL	lpProviderId パラメーターが有効なプロバイダーを指定していません。
WSAEFAULT	lpszProviderDllPath または lpErrno がユーザーアドレス空間の有効な部分にないか、lpProviderDllPathLen が小さすぎます。

解説(Remarks)

WPUGetProviderPath 関数は、指定したプロバイダーの DLL パスを取得します。この DLL パスは null 終端で、埋め込まれた環境文字列 (%SystemRoot% など) を含むことがあります。そのため、LoadLibrary で使用する前に文字列を展開する必要があります。詳細については、LoadLibrary を参照してください。

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