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結構。
WSCInstallNameSpaceEx 和 WSCInstallNameSpaceEx32 函式是用來使用 NAPI_PROVIDER_INSTALLATION_BLOB 結構來安裝NS_EMAIL命名空間的命名空間提供者。
WSAEnumNameSpaceProvidersEx 和 WSCEnumNameSpaceProvidersEx32 函式可用來列舉所有命名空間提供者, (包括NS_EMAIL命名空間提供者) ,並在提供者在安裝時註冊 Blob 時擷取提供者的NAPI_PROVIDER_INSTALLATION_BLOB結構。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
標頭 | nsemail.h |