NAPI_PROVIDER_LEVEL 枚举 (nsemail.h)

项目
08/25/2023

NAPI_PROVIDER_LEVEL枚举指定给定域NS_EMAIL命名空间提供程序的提供程序颁发机构级别。

语法

typedef enum napi_provider_level_tag {
  ProviderLevel_None = 0,
  ProviderLevel_Secondary,
  ProviderLevel_Primary
} NAPI_PROVIDER_LEVEL;

常量


`ProviderLevel_None` 值： 0 命名空间提供程序不支持当前域。此值可用于暂时关闭对域的支持，而无需将其从支持的域列表中删除。如果在安装和注册提供程序时，在给定域的NAPI_DOMAIN_DESCRIPTION_BLOB的 AuthLevel 成员中设置了ProviderLevel_None，则不会调用命名空间提供程序来解析或注册该域中的地址，除非提供程序注册为通配符提供程序。对于一个值为 ProviderLevel_None 的域，可能有多个 NS_EMAIL命名空间提供程序。如果具有此值的命名空间提供程序也注册为通配符提供程序，则按它们在 Winsock 目录中出现的顺序调用这些提供程序。
`ProviderLevel_Secondary` 命名空间提供程序是NS_EMAIL命名空间中的域的辅助提供程序。如果命名空间提供程序可以解析并注册此域NS_EMAIL名称，并且提供与主提供程序提供的相同答案，则命名空间提供程序可以是目标域中的辅助提供程序。如果在安装和注册提供程序时在给定域NAPI_DOMAIN_DESCRIPTION_BLOB的 AuthLevel 成员中设置了ProviderLevel_Secondary，则当域的主提供程序当前不可用或主提供程序无法解析或注册该域中的地址时，将调用此提供程序。对于值为 ProviderLevel_Secondary 的域，可能有多个辅助 NS_EMAIL命名空间提供程序。如果有多个辅助命名空间提供程序，则按它们在 Winsock 目录中出现的顺序调用这些提供程序。
`ProviderLevel_Primary` 命名空间提供程序是NS_EMAIL命名空间中域的主提供程序。如果命名空间提供程序拥有该域的所有NS_EMAIL名称，并且有权访问所有此类名称的主数据，则命名空间提供程序可以声明为域的主提供程序。对于在本地系统上注册的域，应只有一个主NS_EMAIL命名空间提供程序。注意不应有两个NS_EMAIL命名空间提供程序声明为同一域的主提供程序。如果多个提供程序尝试注册为同一域的主提供程序，则会调用域的 Winsock 命名空间目录中作为主提供程序找到的第一个提供程序。将忽略所有其他提供程序声明为主提供程序。

注解

Windows Vista 及更高版本支持此枚举。

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

除了指定的域，NS_EMAIL命名空间提供程序还可以注册为通配符提供程序，以尝试和支持任何域，方法是在安装提供程序时传递的NAPI_PROVIDER_INSTALLATION_BLOB中将 fSupportsWildCard 成员指定为非零值。

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

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

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

NAPI_DOMAIN_DESCRIPTION_BLOB 结构在 NAPI_PROVIDER_INSTALLATION_BLOB 结构中用于描述NS_EMAIL命名空间提供程序。

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

WSAEnumNameSpaceProvidersEx 和 WSCEnumNameSpaceProvidersEx32 函数用于枚举NS_EMAIL命名空间的命名空间提供程序，并检索提供程序的NAPI_PROVIDER_INSTALLATION_BLOB结构。

要求

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