NAPI_PROVIDER_LEVEL-Enumeration (nsemail.h)

Die NAPI_PROVIDER_LEVEL-Enumeration gibt die Anbieterautoritätsebene eines NS_EMAIL Namespaceanbieters für eine bestimmte Domäne an.

Syntax

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

Konstanten

ProviderLevel_None Wert: 0 Der Namespaceanbieter unterstützt die aktuelle Domäne nicht. Dieser Wert kann verwendet werden, um die Unterstützung für eine Domäne vorübergehend zu deaktivieren, ohne sie aus der Liste der unterstützten Domänen zu entfernen. Wenn ProviderLevel_None im AuthLevel-Member des NAPI_DOMAIN_DESCRIPTION_BLOB für eine bestimmte Domäne festgelegt ist, wenn der Anbieter installiert und registriert wird, wird der Namespaceanbieter nicht aufgerufen, um eine Adresse in dieser Domäne aufzulösen oder zu registrieren, es sei denn, der Anbieter ist als Wildcardanbieter registriert. Es können mehrere NS_EMAIL Namespaceanbieter für eine Domäne mit dem Wert ProviderLevel_None vorhanden sein. Wenn Namespaceanbieter mit diesem Wert vorhanden sind, die ebenfalls als Wildcardanbieter registriert sind, werden die Anbieter in der Reihenfolge aufgerufen, in der sie im Winsock-Katalog angezeigt werden.
ProviderLevel_Secondary Der Namespaceanbieter ist ein sekundärer Anbieter für eine Domäne im NS_EMAIL-Namespace. Ein Namespaceanbieter kann ein sekundärer Anbieter in der Zieldomäne sein, wenn der Anbieter NS_EMAIL Namen für diese Domäne auflösen und registrieren kann und dieselbe Antwort wie ein primärer Anbieter geben würde. Wenn ProviderLevel_Secondary im AuthLevel-Mitglied des NAPI_DOMAIN_DESCRIPTION_BLOB für eine bestimmte Domäne festgelegt ist, wenn der Anbieter installiert und registriert wird, wird dieser Anbieter aufgerufen, wenn ein primärer Anbieter für die Domäne derzeit nicht verfügbar ist oder der primäre Anbieter die Adresse in dieser Domäne nicht auflösen oder registrieren konnte. Möglicherweise gibt es mehrere sekundäre NS_EMAIL Namespaceanbieter für eine Domäne mit dem Wert ProviderLevel_Secondary. Wenn mehrere sekundäre Namespaceanbieter vorhanden sind, werden die Anbieter in der Reihenfolge aufgerufen, in der sie im Winsock-Katalog angezeigt werden.
ProviderLevel_Primary Der Namespaceanbieter ist der primäre Anbieter für eine Domäne im NS_EMAIL Namespace. Ein Namespaceanbieter kann behaupten, der primäre Anbieter für eine Domäne zu sein, wenn er alle NS_EMAIL Namen für diese Domäne besitzt und somit Zugriff auf die master Daten für alle solchen Namen hat. Es sollte nur ein einzelner primärer NS_EMAIL Namespaceanbieter für eine Domäne vorhanden sein, die auf dem lokalen System registriert ist. Hinweis Es sollte nie zwei NS_EMAIL Namespaceanbieter geben, die behaupten, der primäre Anbieter für dieselbe Domäne zu sein. Wenn mehrere Anbieter versuchen, sich als primärer Anbieter für dieselbe Domäne zu registrieren, wird der erste Anbieter im Winsock-Namespacekatalog für die Domäne als primärer Anbieter aufgerufen. Alle anderen Anbieteransprüche als primärer Anbieter werden ignoriert.

Hinweise

Diese Enumeration wird unter Windows Vista und höher unterstützt.

Die NAPI_PROVIDER_LEVEL-Enumeration wird von der NAPI_DOMAIN_DESCRIPTION_BLOB-Struktur verwendet, um die Autoritätsebene eines NS_EMAIL Namespaceanbieters für eine Domäne anzugeben. Jeder Namespaceanbieter, der im NS_EMAIL-Namespace registriert ist, kann mehrere Domänen unterstützen. Die Liste der unterstützten Domänen wird im Anbieterregistrierungsblob als Liste mit NAPI_DOMAIN_DESCRIPTION_BLOB Strukturen angegeben. Jede unterstützte Domänenspezifikation enthält einen NAPI_PROVIDER_LEVEL Wert im AuthLevel-Member des NAPI_DOMAIN_DESCRIPTION_BLOB , der den Typ der Unterstützung beschreibt, die vom Anbieter für diese Domäne bereitgestellt wird.

Zusätzlich zur angegebenen Domäne kann sich ein NS_EMAIL-Namespaceanbieter auch als Wildcardanbieter registrieren, um eine beliebige Domäne zu unterstützen, indem er das fSupportsWildCard-Mitglied in der NAPI_PROVIDER_INSTALLATION_BLOB angeben, die bei der Installation des Anbieters übergeben wird.

Namespaceanbieter werden in der folgenden Reihenfolge aufgerufen, um eine Adresse in einer Domäne aufzulösen oder zu registrieren. Wenn ein Namespaceanbieter als primärer Anbieter für die Domäne registriert ist, wird zuerst dieser primäre Anbieter aufgerufen. Es gibt zwei Fälle, die davon abhängen, ob autoritative Ergebnisse in der Namespaceabfrage angefordert werden. Die Standardeinstellung für eine Abfrage besteht darin, autoritative Ergebnisse anzufordern.

Wenn autoritative Ergebnisse in der Abfrage angefordert werden, werden Namespaceanbieter wie folgt aufgerufen. Wenn der primäre Anbieter nicht verfügbar ist oder die Adresse nicht auflösen oder registrieren kann, wird der erste sekundäre Anbieter im Winsock-Katalog aufgerufen. Wenn der sekundäre Anbieter nicht verfügbar ist oder die Adresse nicht auflösen oder registrieren kann, wird der nächste sekundäre Anbieter im Winsock-Katalog aufgerufen. Wenn alle sekundären Anbieter nicht verfügbar sind oder die Adresse nicht auflösen oder registrieren können, wird der erste Wildcardanbieter im Winsock-Katalog aufgerufen. Wenn der erste Wildcardanbieter nicht verfügbar ist oder die Adresse nicht auflösen oder registrieren kann, wird der nächste Wildcardanbieter im Winsock-Katalog aufgerufen.

Wenn nicht autorisierende Ergebnisse in der Abfrage angefordert werden, werden Namespaceanbieter wie folgt aufgerufen. Der primäre Anbieter, alle sekundären Anbieter und alle Wildcardanbieter werden aufgerufen, und die Ergebnisse aller Abfragen werden zurückgegeben. Der primäre Anbieter wird zuerst aufgerufen. Sekundäre Anbieter werden als Nächstes aufgerufen, basierend auf der Reihenfolge im Winsock-Katalog. Als Nächstes werden Die Wildcard-Anbieter basierend auf der Reihenfolge im Winsock-Katalog aufgerufen. Die zurückgegebenen Ergebnisse basieren auf der Reihenfolge der Abfragen.

Die NAPI_DOMAIN_DESCRIPTION_BLOB-Struktur wird in der NAPI_PROVIDER_INSTALLATION_BLOB-Struktur verwendet, um einen NS_EMAIL-Namespaceanbieter zu beschreiben.

Die Funktionen WSCInstallNameSpaceEx und WSCInstallNameSpaceEx32 werden verwendet, um einen Namespaceanbieter für den NS_EMAIL Namespace mithilfe einer NAPI_PROVIDER_INSTALLATION_BLOB-Struktur zu installieren.

Die Funktionen WSAEnumNameSpaceProvidersEx und WSCEnumNameSpaceProvidersEx32 werden verwendet, um Namespaceanbieter für den NS_EMAIL Namespace aufzulisten und die NAPI_PROVIDER_INSTALLATION_BLOB-Struktur für einen Anbieter abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	nsemail.h

Weitere Informationen

NAPI_DOMAIN_DESCRIPTION_BLOB

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32