NAPI_DOMAIN_DESCRIPTION_BLOB 结构 (nsemail.h)

项目
03/05/2024

NAPI_DOMAIN_DESCRIPTION_BLOB 结构描述由命名空间提供程序为NS_EMAIL命名空间处理的域。

语法

typedef struct napi_domain_description_blob_tag {
  DWORD AuthLevel;
  DWORD cchDomainName;
  DWORD OffsetNextDomainDescription;
  DWORD OffsetThisDomainName;
} NAPI_DOMAIN_DESCRIPTION_BLOB;

成员

AuthLevel

此域的命名空间提供程序的颁发机构级别。此成员可以是 Nsemail.h 头文件中定义的 NAPI_PROVIDER_LEVEL 枚举类型的值之一。

cchDomainName

包含 OffsetThisDomainName 成员表示的域名的 Unicode 字符串的长度（以 Unicode 字符为单位）。计算长度时，不计算 NULL 终止符。

OffsetNextDomainDescription

到NAPI_PROVIDER_INSTALLATION_BLOB结构的下一 个NAPI_DOMAIN_DESCRIPTION_BLOB 结构的偏移量（以字节为单位）。

OffsetThisDomainName

与 Unicode 字符串的偏移量（以字节为单位），该字符串包含此命名空间提供程序为NS_EMAIL命名空间处理的域名。域名的长度必须至少为 cchDomainName Unicode 字符。建议使用包含域名的 Unicode 字符串的 NULL 终止，但不是必需的。此偏移量必须在至少两字节边界上对齐。

注解

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

NAPI_DOMAIN_DESCRIPTION_BLOB 结构描述由命名空间提供程序为NS_EMAIL命名空间处理的域。此结构中 OffsetThisDomainName 成员表示的典型域名可能是 msn.com 或 yahoo.com。

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

NAPI_DOMAIN_DESCRIPTION_BLOB 结构是用于描述和注册NS_EMAIL命名空间提供程序的 NAPI_PROVIDER_INSTALLATION_BLOB 结构的成员。 NS_EMAIL命名空间提供程序的NAPI_PROVIDER_INSTALLATION_BLOB结构中可能有多个NAPI_DOMAIN_DESCRIPTION_BLOB结构。

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

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

要求

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