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 有效，但未找到所请求类型的数据。
WSANOTINITIALISED
 尚未初始化 WS2_32.DLL。 应用程序必须先调用 WSAStartup， 然后才能调用任何 Windows 套接字函数。

注解

注意

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

要求

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

另请参阅

WSAStartup

Winsock 函数

Winsock 参考