NAPI_PROVIDER_INSTALLATION_BLOB結構 (nsemail.h)
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 成員開始，用來描述這個NS_EMAIL命名空間提供者所支援之網域的NAPI_DOMAIN_DESCRIPTION_BLOB結構數目。
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命名空間提供者) ，並在提供者在安裝時註冊 Blob 時擷取提供者的NAPI_PROVIDER_INSTALLATION_BLOB結構。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 | nsemail.h |