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 で入手できます。

エラー コード 意味
WSAEINVAL
lpProviderId パラメーターで有効なプロバイダーが指定されていません。
WSAEFAULT
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

こちらもご覧ください

WSCEnumProtocols

WSCInstallProvider