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 會 傳回零。 否則，它會傳回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