WSAGetServiceClassInfoA 函数（winsock2.h）

项目
11/20/2024

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

语法

INT WSAAPI WSAGetServiceClassInfoA(
  [in]      LPGUID                 lpProviderId,
  [in]      LPGUID                 lpServiceClassId,
  [in, out] LPDWORD                lpdwBufSize,
  [out]     LPWSASERVICECLASSINFOA 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	请求的名称有效，但找不到所请求类型的数据。
WSANOTINITIALIZED	尚未初始化WS2_32.DLL。在调用任何 Windows 套接字函数之前，应用程序必须先调用 WSAStartup。
WSATYPE_NOT_FOUND	找不到指定的类。

言论

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

注意

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

要求

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