SERVICE_TYPE_VALUE_ABSW结构 (nspapi.h)

SERVICE_TYPE_VALUE_ABS 结构包含有关网络服务类型值的信息。 此信息可能特定于命名空间。

语法

typedef struct _SERVICE_TYPE_VALUE_ABSW {
  DWORD  dwNameSpace;
  DWORD  dwValueType;
  DWORD  dwValueSize;
  LPWSTR lpValueName;
  PVOID  lpValue;
} SERVICE_TYPE_VALUE_ABSW, *PSERVICE_TYPE_VALUE_ABSW, *LPSERVICE_TYPE_VALUE_ABSW;

成员

dwNameSpace

类型:DWORD

一个命名空间,或一组默认命名空间,其网络服务类型值是预期的。 命名空间提供程序将仅查看适用于其命名空间的值。

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

价值 意义
NS_DEFAULT
一组默认命名空间。 该函数查询此集中的每个命名空间。 默认命名空间集通常包括系统上安装的所有命名空间。 但是,系统管理员可以从集中排除特定命名空间。 NS_DEFAULT是大多数应用程序应用于 dwNameSpace的值。
NS_DNS
Internet 中使用的域名系统用于主机名解析。
NS_NETBT
基于 TCP/IP 层的 NetBIOS。 所有 Windows 操作系统都将其计算机名称注册到 NetBIOS。 此命名空间用于将计算机名称转换为使用此注册的 IP 地址。 请注意,NS_NETBT可以访问 WINS 服务器来执行解析。
NS_SAP
NetWare 服务广告协议。 如果适用,可能会访问 NetWare 绑定程序。 NS_SAP是一个允许注册服务的动态命名空间。
NS_TCPIP_HOSTS
<systemroot>\system32\drivers\etc\hosts 文件中的查阅值。
NS_TCPIP_LOCAL
本地 TCP/IP 名称解析机制,包括与本地主机名进行比较,并在主机缓存中查找主机名和 IP 地址与 IP 地址映射。

dwValueType

类型:DWORD

值数据的类型。 指定以下类型之一:

价值 意义
REG_BINARY
任何形式的二进制数据。
REG_DWORD
32 位数字。
REG_MULTI_SZ
以 null 结尾的字符串数组,以两个 null 字符结尾。
REG_SZ
以 null 结尾的字符串。

dwValueSize

类型:DWORD

lpValue 成员指向的值的大小(以字节为单位)。 对于REG_SZ和REG_MULTI_SZ字符串数据,终止字符将计为大小的一部分。

lpValueName

类型:LPTSTR

指向 NULL终止字符串的指针,该字符串是值的名称。 此名称特定于命名空间。

多个常用的值名称字符串与定义的常量相关联。 这些名称字符串包括以下内容。

不断 意义
SERVICE_TYPE_VALUE_SAPID
“SapId”
SERVICE_TYPE_VALUE_CONN
“ConnectionOriented”
SERVICE_TYPE_VALUE_TCPPORT
“TcpPort”
SERVICE_TYPE_VALUE_UDPPORT
“UdpPort”

lpValue

类型:PVOID

指向值数据的指针。

言论

使用 SetService 函数将网络服务类型添加到命名空间时,SERVICE_TYPE_INFO_ABS 结构作为 ServiceSpecificInfoSERVICE_INFO 结构的 BLOB 成员传递。 尽管 ServiceSpecificInfo 成员通常不应包含指针,但在 SERVICE_TYPE_INFO_ABSSERVICE_TYPE_VALUE_ABS 结构的情况下将发生异常。

注意

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

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
标头 nspapi.h

另请参阅

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService