WSAInstallServiceClassA 函数 (winsock2.h)

WSAInstallServiceClass 函数在命名空间中注册服务类架构。 此架构包括类名、类标识符以及服务的所有实例通用的任何特定于命名空间的信息,例如 SAP 标识符或对象标识符。

语法

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

参数

[in] lpServiceClassInfo

服务类到命名空间特定类型映射信息。 可以一次处理多个映射。

有关相关数据结构的说明,请参阅 服务类 数据结构部分。

返回值

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

错误代码 含义
WSA_INVALID_PARAMETER
命名空间提供程序无法提供请求的类信息。
WSA_NOT_ENOUGH_MEMORY
内存不足,无法执行操作。
WSAEACCES
调用函数没有足够的权限来安装服务。
WSAEALREADY
已为此服务类标识符注册服务类信息。 若要修改服务类信息,请先使用 WSARemoveServiceClass,然后使用更新的类信息数据重新安装。
WSAEINVAL
服务类信息无效或结构不正确。 如果 lpServiceClassInfo 参数为 NULL,则返回此错误。
WSAEOPNOTSUPP
此操作不受支持。 如果命名空间提供程序未实现此函数,则返回此错误。
WSANO_DATA
请求的名称有效,但找不到请求的类型的数据。
WSANOTINITIALIZED
尚未初始化 WS2_32.DLL。 应用程序必须先调用 WSAStartup, 然后才能调用任何 Windows 套接字函数。

注解

注意

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

要求

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

另请参阅

WSAGetLastError

WSAGetServiceClassInfo

WSASERVICECLASSINFO

Winsock 函数

Winsock 参考