NAPI_DOMAIN_DESCRIPTION_BLOB結構 (nsemail.h)

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

Unicode 字串的長度,以 Unicode 字元表示,其中包含 OffsetThisDomainName 成員所代表的功能變數名稱。 計算長度時,不會計算 NULL 終止符。

OffsetNextDomainDescription

NAPI_PROVIDER_INSTALLATION_BLOB 結構中下一個NAPI_DOMAIN_DESCRIPTION_BLOB結構的位移,以位元組為單位。

OffsetThisDomainName

位移,以位元組為單位,包含這個命名空間提供者針對NS_EMAIL命名空間所處理的功能變數名稱的 Unicode 字串。 功能變數名稱長度必須至少為 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 結構是NAPI_PROVIDER_INSTALLATION_BLOB結構的成員,用來描述和註冊NS_EMAIL命名空間提供者。 NS_EMAIL命名空間提供者的NAPI_PROVIDER_INSTALLATION_BLOB結構中可能會有多個NAPI_DOMAIN_DESCRIPTION_BLOB結構。

WSCInstallNameSpaceExWSCInstallNameSpaceEx32 函式是用來使用 NAPI_PROVIDER_INSTALLATION_BLOB 結構來安裝NS_EMAIL命名空間的命名空間提供者。

WSAEnumNameSpaceProvidersExWSCEnumNameSpaceProvidersEx32 函式可用來列舉所有命名空間提供者, (包括NS_EMAIL命名空間提供者) ,並在提供者在安裝時註冊 Blob 時擷取提供者的NAPI_PROVIDER_INSTALLATION_BLOB結構。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 nsemail.h

另請參閱

NAPI_PROVIDER_INSTALLATION_BLOB

NAPI_PROVIDER_LEVEL

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32