WPUGetProviderPath 関数 (ws2spi.h)

  • [アーティクル]

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

構文

int WPUGetProviderPath(
  [in]      LPGUID lpProviderId,
  [out]     WCHAR  *lpszProviderDllPath,
  [in, out] LPINT  lpProviderDllPathLen,
  [out]     LPINT  lpErrno
);

パラメーター

[in] lpProviderId

プロバイダーのローカル一意識別子。 これは、 WSCEnumProtocols を使用して取得した値である必要があります。

[out] lpszProviderDllPath

プロバイダー DLL のパスを識別する文字列を含むバッファーへのポインター。 このパスは null で終わる文字列であり、埋め込まれた環境文字列 (%SystemRoot%) は展開されていません。

[in, out] lpProviderDllPathLen

lpszProviderDllPath が指すバッファーのサイズ (文字単位)。

[out] lpErrno

エラー コードへのポインター。

戻り値

エラーが発生しない場合、 WPUGetProviderPath は 0 を返します。 それ以外の場合はSOCKET_ERRORを返し、 lpErrno で特定のエラー コードを使用できます。

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

解説

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ws2spi.h

関連項目

WSCEnumProtocols

WSCInstallProvider