setServiceA 函数 (nspapi.h)

  • 项目

SetService 函数在注册表中注册或删除一个或多个命名空间中的网络服务。 函数还可以添加或删除一个或多个命名空间中的网络服务类型。

注意SetService 函数已过时。 独立于协议的名称解析中详述的函数在 Windows 套接字 2 中提供了等效的功能。 为方便 Windows 套接字 1.1 开发人员，参考资料如下所示。
 

语法

INT SetServiceA(
  [in]           DWORD                dwNameSpace,
  [in]           DWORD                dwOperation,
  [in]           DWORD                dwFlags,
  [in]           LPSERVICE_INFOA      lpServiceInfo,
  [in, optional] LPSERVICE_ASYNC_INFO lpServiceAsyncInfo,
  [out]          LPDWORD              lpdwStatusFlags
);

参数

[in] dwNameSpace

函数将在其中运行的命名空间或一组默认命名空间。

使用以下常量之一指定命名空间。

值 含义
NS_DEFAULT
 一组默认命名空间。 函数查询此集中的每个命名空间。 默认命名空间集通常包括系统上安装的所有命名空间。 但是，系统管理员可以从集中排除特定的命名空间。 NS_DEFAULT是大多数应用程序应用于 dwNameSpace 的值。
NS_DNS
 Internet 中用于解析主机名称的域名系统。
NS_NDS
 NetWare 4 提供程序。
NS_NETBT
 基于 TCP/IP 层的 NetBIOS。 所有 Windows 系统都将其计算机名称注册到 NetBIOS。 此命名空间用于将计算机名称转换为使用此注册的 IP 地址。
NS_SAP
 NetWare 服务广告协议。 这可以访问 NetWare 绑定（如果适用）。 NS_SAP是启用服务注册的动态命名空间。
NS_TCPIP_HOSTS
 systemroot>\system32\drivers\etc\posts 文件中的<查找值。
NS_TCPIP_LOCAL
 本地 TCP/IP 名称解析机制，包括与主机到 IP 地址映射缓存中本地主机名和查找值的比较。

[in] dwOperation

函数将执行的操作。 使用以下值之一指定操作：

值 含义
SERVICE_REGISTER
 将网络服务注册到 命名空间。 此操作可与 SERVICE_FLAG_DEFER 和 SERVICE_FLAG_HARD 位标志一起使用。
SERVICE_DEREGISTER
 从注册表中删除命名空间中的网络服务。 此操作可与 SERVICE_FLAG_DEFER 和 SERVICE_FLAG_HARD 位标志一起使用。
SERVICE_FLUSH
 执行调用的任何操作，并将 SERVICE_FLAG_DEFER 位标志设置为 1。
SERVICE_ADD_TYPE
 将服务类型添加到 命名空间。

对于此操作，请使用 lpServiceInfo 指向的 SERVICE_INFO 结构的 ServiceSpecificInfo 成员传递SERVICE_TYPE_INFO_ABS结构。 还必须设置 SERVICE_INFO 结构的 ServiceType 成员。 忽略其他 SERVICE_INFO 成员。
SERVICE_DELETE_TYPE
 从 命名空间中删除由指定SERVICE_ADD_TYPE操作的先前调用添加的服务类型。

[in] dwFlags

一组用于修改函数操作的位标志。 可以设置以下一个或多个位标志：

值 含义
SERVICE_FLAG_DEFER
 仅当操作SERVICE_REGISTER或SERVICE_DEREGISTER时，此位标志才有效。

如果此位标志为 1 且有效，则命名空间提供程序应延迟注册或取消注册操作，直到请求SERVICE_FLUSH操作。
SERVICE_FLAG_HARD
 仅当操作SERVICE_REGISTER或SERVICE_DEREGISTER时，此位标志才有效。

如果此位标志为 1 且有效，则命名空间提供程序在执行操作时更新任何相关的持久存储信息。

例如：如果操作涉及在使用持久性存储的命名空间中取消注册，则命名空间提供程序将删除相关的持久存储信息。

[in] lpServiceInfo

指向包含有关网络服务或服务类型信息的 SERVICE_INFO 结构的指针。

[in, optional] lpServiceAsyncInfo

保留供将来使用。 必须设置为 NULL。

[out] lpdwStatusFlags

接收函数状态信息的一组位标志。 定义了以下位标志：

值 含义
SET_SERVICE_ PARTIAL_SUCCESS
 一个或多个命名空间提供程序无法成功执行请求的操作。

返回值

如果函数失败，则返回值SOCKET_ERROR。 要获得更多的错误信息，请调用 GetLastError。 GetLastError 可以返回以下扩展错误值。

错误代码 含义
已注册ERROR_ALREADY_
 函数尝试注册已注册的服务。

注解

注意

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

要求

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

另请参阅

GetService

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

Winsock 函数

Winsock 参考