WSANAMESPACE_INFOW 结构 (winsock2.h)

项目
08/27/2023

WSANAMESPACE_INFO 结构包含命名空间提供程序的所有注册信息。

语法

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

成员

NSProviderId

类型： GUID

此命名空间提供程序的唯一 GUID。

dwNameSpace

类型：DWORD

此提供程序支持的命名空间。

dwNameSpace 成员的可能值列在 Winsock2.h include 文件中。 Windows Vista 及更高版本包含多个命名空间提供程序。可以安装其他命名空间提供程序，因此以下可能的值仅是通常可用的值。许多其他值是可能的。

值	含义
NS_BTH	蓝牙命名空间。 Windows Vista 及更高版本支持此命名空间标识符。
NS_DNS	域名系统 (DNS) 命名空间。
NS_EMAIL	电子邮件命名空间。 Windows Vista 及更高版本支持此命名空间标识符。
NS_NLA	网络位置感知 (NLA) 命名空间。 Windows XP 及更高版本支持此命名空间标识符。
NS_NTDS	Windows NT目录服务 (NTDS) 命名空间。
NS_PNRPNAME	特定对等名称的对等名称空间。 Windows Vista 及更高版本支持此命名空间标识符。
NS_PNRPCLOUD	对等名称集合的对等名称空间。 Windows Vista 及更高版本支持此命名空间标识符。

fActive

类型： BOOL

如果 为 TRUE，则指示此命名空间提供程序处于活动状态。如果 为 FALSE，则命名空间提供程序处于非活动状态，并且查询不可访问，即使查询专门引用此命名空间提供程序也是如此。

dwVersion

类型：DWORD

命名空间提供程序的版本号。

lpszIdentifier

类型： LPTSTR

标识命名空间提供程序的显示字符串。

注解

WSAEnumNameSpaceProviders 和 WSCEnumNameSpaceProviders32 函数使用 WSANAMESPACE_INFO 结构返回有关可用命名空间提供程序的信息。 WSANAMESPACE_INFO结构包含有关在安装命名空间提供程序时传递给 WSCInstallNameSpace 和 WSCInstallNameSpace32 函数的命名空间条目的提供程序特定信息。

定义 UNICODE 或 _UNICODE 时， WSANAMESPACE_INFO 定义为 WSANAMESPACE_INFOW，此数据结构的 Unicode 版本和 lpszIdentifier 字符串成员定义为 LPWSTR 数据类型。

如果未定义 UNICODE 或 _UNICODE，WSANAMESPACE_INFO 定义为 WSANAMESPACE_INFOA，此数据结构的 ANSI 版本和 lpszIdentifier 字符串成员定义为 LPSTR 数据类型。

在 Windows Vista 及更高版本上， WSANAMESPACE_INFOEX（ WSANAMESPACE_INFO 结构的增强版本）通过调用 WSAEnumNameSpaceProvidersEx 和 WSCEnumNameSpaceProvidersEx32 函数返回

注意

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

要求

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