WSANAMESPACE_INFOW结构（winsock2.h）

项目
11/20/2024

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

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

Winsock2.h 包含文件中列出了 dwNameSpace 成员的可能值。 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 使用 WSANAMESPACE_INFO 结构，WSCEnumNameSpaceProviders32 函数返回有关可用命名空间提供程序的信息。 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