WSAGetServiceClassNameByClassIdA 函数 (winsock2.h)

WSAGetServiceClassNameByClassId 函数检索与指定类型关联的服务的名称。 此名称是通用服务名称,如 FTP 或 SNA,而不是该服务的特定实例的名称。

语法

INT WSAAPI WSAGetServiceClassNameByClassIdA(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPSTR   lpszServiceClassName,
  [in, out] LPDWORD lpdwBufferLength
);

参数

[in] lpServiceClassId

指向服务类的 GUID 的指针。

[out] lpszServiceClassName

指向服务名称的指针。

[in, out] lpdwBufferLength

在输入时,lpszServiceClassName返回的缓冲区的长度(以字符为单位)。 输出时,复制到 lpszServiceClassName的服务名称的长度(以字符为单位)。

返回值

WSAGetServiceClassNameByClassId 函数返回一个值零(如果成功)。 否则,返回值SOCKET_ERROR,可以通过调用 WSAGetLastError来检索特定的错误号。

错误代码 意义
WSA_INVALID_PARAMETER
指定的 lpServiceClassId 参数无效。
WSA_NOT_ENOUGH_MEMORY
内存不足,无法执行操作。
WSAEACCES
调用例程没有足够的权限来访问信息。
WSAEFAULT
lpszServiceClassName 指向的指定缓冲区太小。 传入更大的缓冲区。
WSAENOBUFS
没有可用的缓冲区空间。
WSAEOPNOTSUPP
引用的对象类型不支持该操作。 某些不支持获取服务类信息的命名空间提供程序返回此错误。
WSANO_DATA
lpServiceClassId 有效,但找不到请求类型的数据。
WSANOTINITIALIZED
尚未初始化WS2_32.DLL。 在调用任何 Windows 套接字函数之前,应用程序必须先调用 WSAStartup

言论

注意

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

要求

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

另请参阅

WSAStartup

Winsock 函数

Winsock 参考