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 會傳回零。 否則，它會傳回SOCKET_ERROR。 lpErrno 提供特定的錯誤碼。

錯誤碼 意義
WSAEINVAL
 lpProviderId 參數未指定有效的提供者。
WSAEFAULT
 lpszProviderDllPath 或 lpErrno 參數不在使用者地址空間的有效部分，或 lpProviderDllPathLen 太小。

備註

WSCGetProviderPath 函式會擷取指定提供者的 DLL 路徑。 DLL 路徑可以包含內嵌的環境字串，例如 %SystemRoot%，因此應該在與 Windows LoadLibrary 函式搭配使用之前進行擴充。 如需詳細資訊，請參閱 LoadLibrary。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ws2spi.h
程式庫 Ws2_32.lib
Dll Ws2_32.dll

另請參閱

WSCEnumProtocols

WSCInstallProvider