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中提供特定的錯誤碼。
錯誤碼 | 意義 |
---|---|
lpProviderId參數未指定有效的提供者。 | |
lpszProviderDllPath或lpErrno不在使用者位址空間的有效部分,或lpProviderDllPathLen太小。 |
備註
WPUGetProviderPath函式會擷取指定提供者的 DLL 路徑。 DLL 路徑是以 Null 結尾,而且可能包含內嵌的環境字串 (,例如 %SystemRoot%) 。 因此,在搭配 LoadLibrary使用之前,應該先展開字串。 如需詳細資訊,請參閱 LoadLibrary。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ws2spi.h |