WSAGetServiceClassInfoW 函数 (winsock2.h)

项目
03/04/2024

WSAGetServiceClassInfo 函数从指定的命名空间提供程序中检索与指定服务类相关的 (架构) 类信息。

语法

INT WSAAPI WSAGetServiceClassInfoW(
  [in]      LPGUID                 lpProviderId,
  [in]      LPGUID                 lpServiceClassId,
  [in, out] LPDWORD                lpdwBufSize,
  [out]     LPWSASERVICECLASSINFOW lpServiceClassInfo
);

参数

[in] lpProviderId

指向标识特定命名空间提供程序的 GUID 的指针。

[in] lpServiceClassId

指向标识服务类的 GUID 的指针。

[in, out] lpdwBufSize

输入时， lpServiceClassInfo 参数指向的缓冲区中包含的字节数。

在输出时，如果函数失败且错误为 WSAEFAULT，则此参数指定检索记录所需的指向 lpServiceClassInfo 的缓冲区的最小大小（以字节为单位）。

[out] lpServiceClassInfo

指向 WSASERVICECLASSINFO 结构的指针，该结构包含来自指定服务类的指定命名空间提供程序的服务类信息。

返回值

如果 WSAGetServiceClassInfo 成功，则返回值为零。否则，将返回值 SOCKET_ERROR，并且可以通过调用 WSAGetLastError 来检索特定的错误号。

错误代码	含义
WSA_NOT_ENOUGH_MEMORY	内存不足，无法执行该操作。
WSAEACCES	调用例程没有足够的权限来访问信息。
WSAEFAULT	lpServiceClassInfo 参数指向的缓冲区太小，无法包含 WSASERVICECLASSINFOW。应用程序需要传入更大的缓冲区。
WSAEINVAL	指定的服务类标识符或命名空间提供程序标识符无效。如果 lpProviderId、lpServiceClassId、lpdwBufSize 或 lpServiceClassInfo 参数为 NULL，则返回此错误。
WSAEOPNOTSUPP	引用的对象类型不支持该操作。某些不支持获取服务类信息的命名空间提供程序返回此错误。
WSANO_DATA	请求的名称有效，但找不到请求的类型的数据。
WSANOTINITIALISED	尚未初始化 WS2_32.DLL。应用程序必须先调用 WSAStartup，然后才能调用任何 Windows 套接字函数。
WSATYPE_NOT_FOUND	未找到指定的类。

注解

WSAGetServiceClassInfo 函数从命名空间提供程序检索服务类信息。从特定命名空间提供程序检索的服务类信息可能不是安装服务类时指定的完整类信息集。单个命名空间提供程序只需要保留适用于它们支持的命名空间的服务类信息。有关详细信息，请参阅服务类数据结构部分。

注意

winsock2.h 标头将 WSAGetServiceClassInfo 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	Windows
标头	winsock2.h
Library	Ws2_32.lib
DLL	Ws2_32.dll