nsemail.h) (NAPI_PROVIDER_INSTALLATION_BLOB 结构

项目
08/25/2023

NAPI_PROVIDER_INSTALLATION_BLOB 结构包含为 NS_EMAIL 命名空间安装命名空间提供程序所需的信息。

语法

typedef struct napi_provider_installation_blob_tag {
  DWORD dwVersion;
  DWORD dwProviderType;
  DWORD fSupportsWildCard;
  ULONG cDomains;
  ULONG OffsetFirstDomain;
} NAPI_PROVIDER_INSTALLATION_BLOB;

成员

dwVersion

类型：DWORD

NS_EMAIL命名空间提供程序的版本号。此成员特定于命名空间提供程序。

dwProviderType

类型：DWORD

NS_EMAIL命名空间的命名空间提供程序的类型。此成员可以是 Nsemail.h 头文件中定义的 NAPI_PROVIDER_TYPE 枚举类型的值之一。

fSupportsWildCard

类型：DWORD

一个布尔值，指示此NS_EMAIL命名空间提供程序是否支持通配符名称。如果此成员为非零，则NS_EMAIL提供程序声明可能能够解析或注册不属于该提供程序专门注册为主要或辅助的任何域的任何名称。如果此成员不为零，则可以调用NS_EMAIL提供程序来解析或注册任何地址，前提是域没有可用的主要或辅助提供程序。

可能有多个提供程序声明能够解析 fSupportsWildCard 设置为非零) (任何地址。如果有具有此值的命名空间提供程序也注册为通配符提供程序，则会按照它们在 Winsock 命名空间目录中出现的顺序调用这些提供程序。

cDomains

类型：DWORD

从 OffsetFirstDomain 成员开始的NAPI_DOMAIN_DESCRIPTION_BLOB结构的数目，用于描述此NS_EMAIL命名空间提供程序支持的域。

OffsetFirstDomain

类型：DWORD

到用于描述此NS_EMAIL命名空间提供程序支持的域的多个 NAPI_DOMAIN_DESCRIPTION_BLOB 结构中的第一个的偏移量（以字节为单位）。此偏移量必须在至少四字节边界上对齐。

注解

Windows Vista 及更高版本支持此结构。

NAPI_PROVIDER_INSTALLATION_BLOB 结构包含为 NS_EMAIL 命名空间安装命名空间提供程序所需的信息。在本地系统上安装NS_EMAIL命名空间可能有多个命名空间提供程序。

在 NS_EMAIL 命名空间中注册的每个命名空间提供程序都可以支持多个域。因此， NS_EMAIL 命名空间提供程序的 NAPI_PROVIDER_INSTALLATION_BLOB 结构中可能存在多个NAPI_DOMAIN_DESCRIPTION_BLOB结构。受支持域的列表在提供程序注册 Blob 中指定为 NAPI_DOMAIN_DESCRIPTION_BLOB 结构的列表。每个受支持的域规范在 NAPI_DOMAIN_DESCRIPTION_BLOB 的 AuthLevel 成员中包含一个 NAPI_PROVIDER_LEVEL 值，该值描述提供程序为该域提供的颁发机构级别。

命名空间提供程序按以下顺序调用，以解析或注册域中的地址。如果某个命名空间提供程序注册为域的主提供程序，则首先调用此主提供程序。有两种情况取决于是否在命名空间查询中请求了权威结果。查询的默认值是请求权威结果。

在查询中请求权威结果时，将按如下所示调用命名空间提供程序。如果主提供程序不可用或无法解析或注册地址，则会调用 Winsock 目录中的第一个辅助提供程序。如果辅助提供程序不可用或无法解析或注册地址，则会调用 Winsock 目录中的下一个辅助提供程序。如果所有辅助提供程序都不可用或无法解析或注册地址，则会调用 Winsock 目录中的第一个通配符提供程序。如果第一个通配符提供程序不可用或无法解析或注册地址，则会调用 Winsock 目录中的下一个通配符提供程序。

在查询中请求非权威结果时，将按如下所示调用命名空间提供程序。将调用主提供程序、所有辅助提供程序和所有通配符提供程序，并返回所有查询的结果。首先调用主提供程序。接下来，根据 Winsock 目录中的顺序调用辅助提供程序。接下来会根据 Winsock 目录中的顺序调用通配符提供程序。返回的结果基于查询的顺序。

WSCInstallNameSpaceEx 和 WSCInstallNameSpaceEx32 函数用于使用 NAPI_PROVIDER_INSTALLATION_BLOB 结构为NS_EMAIL命名空间安装命名空间提供程序。

WSAEnumNameSpaceProvidersEx 和 WSCEnumNameSpaceProvidersEx32 函数用于枚举所有命名空间提供程序 (包括) NS_EMAIL命名空间提供程序，以及检索提供程序的NAPI_PROVIDER_INSTALLATION_BLOB结构（如果提供程序在安装时注册了 Blob）。

要求

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