Win32 API 日本語リファレンス
ホーム › Networking.WinSock › LPWSCGETPROVIDERPATH

LPWSCGETPROVIDERPATH

コールバック

シグネチャ

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

パラメーター

フィールド型説明
lpProviderIdGUID*プロバイダーのグローバル一意識別子 (GUID) へのポインターです。この値は WSCEnumProtocols を使用して取得します。
lpszProviderDllPathLPWSTRプロバイダー DLL のパス文字列が返されるバッファーへのポインターです。パスは null で終わる文字列で、%SystemRoot% などの埋め込み環境文字列は展開されていません。
lpProviderDllPathLenINT*lpszProviderDllPath パラメーターが指すバッファーのサイズ (文字数) です。
lpErrnoINT*関数が失敗した場合のエラーコードへのポインターです。

公式ドキュメント

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

戻り値

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

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

解説(Remarks)

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

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