NAPI_PROVIDER_LEVEL列挙 (nsemail.h)

  • [アーティクル]

NAPI_PROVIDER_LEVEL列挙は、特定のドメインのNS_EMAIL名前空間プロバイダーのプロバイダー機関レベルを指定します。

構文

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

定数

 
ProviderLevel_None
値: 0
名前空間プロバイダーは、現在のドメインをサポートしていません。 この値を使用すると、サポートされているドメインの一覧からドメインを削除せずに、ドメインのサポートを一時的にオフにすることができます。

プロバイダーのインストールと登録時に特定のドメインのNAPI_DOMAIN_DESCRIPTION_BLOBの AuthLevel メンバーにProviderLevel_Noneが設定されている場合、プロバイダーがワイルドカード プロバイダーとして登録されていない限り、名前空間プロバイダーは、そのドメインのアドレスを解決または登録するために呼び出されません。

ProviderLevel_Noneの値を持つドメインには、複数の NS_EMAIL名前空間プロバイダーが存在する場合があります。 ワイルドカード プロバイダーとしても登録されているこの値を持つ名前空間プロバイダーがある場合、プロバイダーは Winsock カタログに表示される順序で呼び出されます。
ProviderLevel_Secondary
名前空間プロバイダーは、NS_EMAIL名前空間内のドメインのセカンダリ プロバイダーです。 名前空間プロバイダーは、プロバイダーがこのドメインの NS_EMAIL名前を解決して登録し、プライマリ プロバイダーが提供するのと同じ答えを提供できる場合、ターゲット ドメインのセカンダリ プロバイダーにすることができます。 プロバイダーのインストールと登録時に特定のドメインのNAPI_DOMAIN_DESCRIPTION_BLOBの AuthLevel メンバーにProviderLevel_Secondaryが設定されている場合、ドメインのプライマリ プロバイダーが現在使用できない場合、またはプライマリ プロバイダーがそのドメインのアドレスを解決または登録できなかった場合に、このプロバイダーが呼び出されます。

ProviderLevel_Secondaryの値を持つドメインには、複数のセカンダリ NS_EMAIL名前空間プロバイダーが存在する可能性があります。 複数のセカンダリ名前空間プロバイダーがある場合、プロバイダーは Winsock カタログに表示される順序で呼び出されます。
ProviderLevel_Primary
名前空間プロバイダーは、NS_EMAIL名前空間内のドメインのプライマリ プロバイダーです。 名前空間プロバイダーは、そのドメインのすべてのNS_EMAIL名を所有し、そのようなすべての名前のマスター データにアクセスできる場合、ドメインのプライマリ プロバイダーであることを要求できます。

ローカル システムに登録されているドメインのプライマリ NS_EMAIL名前空間プロバイダーは 1 つだけ必要です。

メモ 同じドメインのプライマリ プロバイダーであると主張する 2 つのNS_EMAIL名前空間プロバイダーは存在しないでください。 複数のプロバイダーが同じドメインのプライマリ プロバイダーとして登録しようとすると、プライマリ プロバイダーとしてドメインの Winsock 名前空間カタログにある最初のプロバイダーが呼び出されます。 プライマリ プロバイダーである他のすべてのプロバイダー要求は無視されます。

 

注釈

この列挙は、Windows Vista 以降でサポートされています。

NAPI_PROVIDER_LEVEL列挙は、ドメインのNS_EMAIL名前空間プロバイダーの権限レベルを指定するために、NAPI_DOMAIN_DESCRIPTION_BLOB構造体によって使用されます。 NS_EMAIL名前空間に登録されている各名前空間プロバイダーは、複数のドメインをサポートできます。 サポートされているドメインの一覧は、プロバイダー登録 BLOB で NAPI_DOMAIN_DESCRIPTION_BLOB 構造の一覧として指定されます。 サポートされている各ドメイン仕様には、そのドメインのプロバイダーによって提供されるサポートの種類を記述するNAPI_DOMAIN_DESCRIPTION_BLOBの AuthLevel メンバーにNAPI_PROVIDER_LEVEL値が含まれています。

指定したドメインに加えて、NS_EMAIL名前空間プロバイダーは、プロバイダーのインストール時に渡されるNAPI_PROVIDER_INSTALLATION_BLOBで fSupportsWildCard メンバーを 0 以外として指定することで、任意のドメインをサポートするワイルドカード プロバイダーとして登録することもできます。

名前空間プロバイダーは、ドメイン内のアドレスを解決または登録するために、次の順序で呼び出されます。 名前空間プロバイダーがドメインのプライマリ プロバイダーとして登録されている場合は、最初にこのプライマリ プロバイダーが呼び出されます。 名前空間クエリで権限のある結果が要求されるかどうかに応じて、2 つのケースがあります。 クエリの既定値は、権限のある結果を要求することです。

クエリで権限のある結果が要求されると、名前空間プロバイダーが次のように呼び出されます。 プライマリ プロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログ内の最初のセカンダリ プロバイダーが呼び出されます。 セカンダリ プロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログ内の次のセカンダリ プロバイダーが呼び出されます。 すべてのセカンダリ プロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログ内の最初のワイルドカード プロバイダーが呼び出されます。 最初のワイルドカード プロバイダーが使用できない場合、またはアドレスを解決または登録できない場合は、Winsock カタログ内の次のワイルドカード プロバイダーが呼び出されます。

クエリで権限のない結果が要求されると、名前空間プロバイダーが次のように呼び出されます。 プライマリ プロバイダー、すべてのセカンダリ プロバイダー、およびすべてのワイルドカード プロバイダーが呼び出され、すべてのクエリの結果が返されます。 プライマリ プロバイダーは最初に呼び出されます。 セカンダリ プロバイダーは、Winsock カタログ内の順序に基づいて次に呼び出されます。 ワイルドカード プロバイダーは、Winsock カタログ内の順序に基づいて次に呼び出されます。 返される結果は、クエリの順序に基づいています。

NAPI_DOMAIN_DESCRIPTION_BLOB構造体は、NS_EMAIL名前空間プロバイダーを記述するために、NAPI_PROVIDER_INSTALLATION_BLOB構造体で使用されます。

WSCInstallNameSpaceEx 関数と WSCInstallNameSpaceEx32 関数は、NAPI_PROVIDER_INSTALLATION_BLOB構造体を使用してNS_EMAIL名前空間の名前空間プロバイダーをインストールするために使用されます。

WSAEnumNameSpaceProvidersEx 関数と WSCEnumNameSpaceProvidersEx32 関数は、NS_EMAIL名前空間の名前空間プロバイダーを列挙し、プロバイダーのNAPI_PROVIDER_INSTALLATION_BLOB構造体を取得するために使用されます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header nsemail.h

こちらもご覧ください

NAPI_DOMAIN_DESCRIPTION_BLOB

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32