通过

SERVICE_TYPE_VALUE_ABSA 结构 (nspapi.h)

  • 项目

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

语法

typedef struct _SERVICE_TYPE_VALUE_ABSA {
  DWORD dwNameSpace;
  DWORD dwValueType;
  DWORD dwValueSize;
  LPSTR lpValueName;
  PVOID lpValue;
} SERVICE_TYPE_VALUE_ABSA, *PSERVICE_TYPE_VALUE_ABSA, *LPSERVICE_TYPE_VALUE_ABSA;

成员

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 结尾的字符串数组，以两个空字符结束。
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结构将作为 SERVICE_INFO 结构的 ServiceSpecificInfo BLOB 成员传递。 尽管 ServiceSpecificInfo 成员通常不应包含指针，但在 SERVICE_TYPE_INFO_ABS 和 SERVICE_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