WSANAMESPACE_INFOEXW 结构 (winsock2.h)
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 及更高版本包含多个命名空间提供程序。 可以安装其他命名空间提供程序,因此以下可能的值仅是通常可用的值。 许多其他值是可能的。
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 |