WSCGetProviderPath 関数 (ws2spi.h)
WSCGetProviderPath 関数は、指定されたプロバイダーの DLL パスを取得します。
構文
int WSCGetProviderPath(
[in] LPGUID lpProviderId,
[out] WCHAR *lpszProviderDllPath,
[in, out] LPINT lpProviderDllPathLen,
[out] LPINT lpErrno
);
パラメーター
[in] lpProviderId
プロバイダーのグローバル一意識別子 (GUID) へのポインター。 この値は、 WSCEnumProtocols を使用して取得されます。
[out] lpszProviderDllPath
プロバイダー DLL のパス文字列が返されるバッファーへのポインター。 パスは null で終わる文字列であり、%SystemRoot% などの埋め込み環境文字列は展開されていません。
[in, out] lpProviderDllPathLen
lpszProviderDllPath パラメーターが指すバッファーのサイズ (文字数)。
[out] lpErrno
関数が失敗した場合のエラー コードへのポインター。
戻り値
エラーが発生しない場合、 WSCGetProviderPath は 0 を返します。 それ以外の場合は、SOCKET_ERRORを返します。 特定のエラー コードは lpErrno で入手できます。
エラー コード | 意味 |
---|---|
lpProviderId パラメーターで有効なプロバイダーが指定されていません。 | |
lpszProviderDllPath または lpErrno パラメーターがユーザー アドレス空間の有効な部分にないか、lpProviderDllPathLen が小さすぎます。 |
注釈
WSCGetProviderPath 関数は、指定されたプロバイダーの DLL パスを取得します。 DLL パスには、%SystemRoot% などの埋め込み環境文字列を含めることができるため、Windows LoadLibrary 関数で使用する前に展開する必要があります。 詳細については、「 LoadLibrary」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | ws2spi.h |
Library | Ws2_32.lib |
[DLL] | Ws2_32.dll |