NAPI_PROVIDER_LEVEL列舉 (nsemail.h)

NAPI_PROVIDER_LEVEL列舉會指定指定網域NS_EMAIL命名空間提供者的提供者授權層級。

Syntax

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

常數

ProviderLevel_None 值： 0 命名空間提供者不支援目前的網域。 這個值可以用來暫時關閉網域的支援，而不需從支援的網域清單中移除它。 如果在安裝及註冊提供者時，在指定網域的 AuthLevel 成員中設定 NAPI_DOMAIN_DESCRIPTION_BLOB ProviderLevel_None，除非提供者註冊為通配符提供者，否則不會呼叫命名空間提供者來解析或註冊該網域中的位址。 網域可能有多個NS_EMAIL命名空間提供者，其值為 ProviderLevel_None。 如果有命名空間提供者也註冊為通配符提供者，則會依提供者出現在 Winsock 目錄中的順序呼叫。
ProviderLevel_Secondary 命名空間提供者是NS_EMAIL命名空間中網域的次要提供者。 如果提供者可以解析並註冊此網域的NS_EMAIL名稱，則命名空間提供者可以是目標網域中的次要提供者，並提供與主要提供者所提供的相同答案。 如果在安裝及註冊提供者時，ProviderLevel_Secondary是在指定網域的 NAPI_DOMAIN_DESCRIPTION_BLOBAuthLevel 成員中設定，則當網域的主要提供者目前無法使用，或主要提供者無法解析或註冊該網域中的位址時，就會呼叫此提供者。 網域可能有多個次要NS_EMAIL命名空間提供者，其值為 ProviderLevel_Secondary。 如果有多個次要命名空間提供者，則會依提供者出現在 Winsock 目錄中的順序呼叫。
ProviderLevel_Primary 命名空間提供者是NS_EMAIL命名空間中網域的主要提供者。 如果命名空間提供者擁有該網域的所有NS_EMAIL名稱，因此可以存取所有這類名稱的主數據，則命名空間提供者可以宣告為網域的主要提供者。 在本機系統上註冊的網域，應該只有單一主要NS_EMAIL命名空間提供者。 注意 不應該有兩個NS_EMAIL命名空間提供者宣告為相同網域的主要提供者。 如果多個提供者嘗試註冊為相同網域的主要提供者，則會呼叫在網域的 Winsock 命名空間目錄中找到的第一個提供者，作為主要提供者。 所有其他要成為主要提供者的提供者宣告都會被忽略。

備註

Windows Vista 和更新版本支援此列舉。

NAPI_PROVIDER_LEVEL列舉是由NAPI_DOMAIN_DESCRIPTION_BLOB結構用來指定網域NS_EMAIL命名空間提供者的授權層級。 在 NS_EMAIL 命名空間中註冊的每個命名空間提供者都可以支援多個網域。 支援的網域清單會在提供者註冊 Blob 中指定為 NAPI_DOMAIN_DESCRIPTION_BLOB 結構清單。 每個支援的網域規格都包含NAPI_DOMAIN_DESCRIPTION_BLOB的 AuthLevel 成員中的NAPI_PROVIDER_LEVEL值，描述提供者為該網域提供的支持類型。

除了指定的網域之外，NS_EMAIL命名空間提供者也可以註冊為通配符提供者，以嘗試及支援任何網域，方法是在安裝提供者時，將 fSupportsWildCard 成員指定為 NAPI_PROVIDER_INSTALLATION_BLOB中傳遞 的非零。

命名空間提供者的呼叫順序如下，以解析或註冊網域中的位址。 如果命名空間提供者註冊為網域的主要提供者，則會先呼叫此主要提供者。 有兩種情況取決於命名空間查詢中是否要求授權結果。 查詢的預設值是要求授權結果。

在查詢中要求授權結果時，會呼叫命名空間提供者，如下所示。 如果主要提供者無法使用或無法解析或註冊位址，則會呼叫 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

另請參閱

NAPI_DOMAIN_DESCRIPTION_BLOB

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32