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 提供特定的錯誤碼。
錯誤碼 | 意義 |
---|---|
lpProviderId 參數未指定有效的提供者。 | |
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 |