WSANAMESPACE_INFOEXW 结构 (winsock2.h)

项目
03/04/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

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

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

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

ProviderSpecific

类型： BLOB

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

注解

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

目前，Windows 附带的唯一使用WSANAMESPACE_INFOEX结构的 ProviderSpecific 成员中信息的命名空间是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 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

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