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
lpszProviderDllPathlpErrno 参数不在用户地址空间的有效部分,或者 lpProviderDllPathLen 太小。

注解

WSCGetProviderPath 函数检索指定提供程序的 DLL 路径。 DLL 路径可以包含嵌入的环境字符串,例如 %SystemRoot%,因此,在与 Windows LoadLibrary 函数一起使用之前,应对其进行扩展。 有关详细信息,请参阅 LoadLibrary

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ws2spi.h
Library Ws2_32.lib
DLL Ws2_32.dll

另请参阅

WSCEnumProtocols

WSCInstallProvider