WSANAMESPACE_INFOEXW结构（winsock2.h）

项目
11/20/2024

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

语法

typedef struct _WSANAMESPACE_INFOEXW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
  BLOB   ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;

成员

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

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

ProviderSpecific

类型：BLOB

与命名空间条目关联的提供程序特定的数据 Blob。

言论

WSANAMESPACE_INFOEX 结构是 WSAEnumNameSpaceProvidersEx 和 WSCEnumNameSpaceProvidersEx32 函数用来返回可用命名空间提供程序信息的 WSANAMESPACE_INFO 结构的增强版本。 WSANAMESPACE_INFOEX 结构包含与在 lpProviderInfo 参数中传递给 WSCInstallNameSpaceEx 和 WSCInstallNameSpaceEx32 函数的命名空间项关联的提供程序特定的数据 blob。

目前，使用 ProviderSpecificWSANAMESPACE_INFOEX 结构成员中的信息的 Windows 包含的唯一命名空间是NS_EMAIL命名空间的命名空间提供程序。 NS_EMAIL命名空间提供程序的 ProviderSpecific 成员的格式是 NAPI_PROVIDER_INSTALLATION_BLOB 结构。

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

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

WSCEnumNameSpaceProvidersEx32 函数是唯一的 Unicode 函数，并返回 WSANAMESPACE_INFOEXW 结构。

注意

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