NAPI_PROVIDER_INSTALLATION_BLOB-Struktur (nsemail.h)

Artikel
08/25/2023

Die NAPI_PROVIDER_INSTALLATION_BLOB-Struktur enthält die Informationen, die zum Installieren eines Namespaceanbieters für den NS_EMAIL-Namespace erforderlich sind.

Syntax

typedef struct napi_provider_installation_blob_tag {
  DWORD dwVersion;
  DWORD dwProviderType;
  DWORD fSupportsWildCard;
  ULONG cDomains;
  ULONG OffsetFirstDomain;
} NAPI_PROVIDER_INSTALLATION_BLOB;

Member

dwVersion

Art: DWORD

Die Versionsnummer des NS_EMAIL Namespaceanbieters. Dieser Member ist spezifisch für den Namespaceanbieter.

dwProviderType

Art: DWORD

Der Typ des Namespaceanbieters für den NS_EMAIL Namespace. Dieser Member kann einer der Werte aus dem NAPI_PROVIDER_TYPE Enumerationstyp sein, der in der Headerdatei Nsemail.h definiert ist.

fSupportsWildCard

Art: DWORD

Ein boolescher Wert, der angibt, ob dieser NS_EMAIL Namespaceanbieter Die Namen von Feldhaltern unterstützt. Wenn dieser Member nicht zero ist, behauptet ein NS_EMAIL Anbieter, dass er möglicherweise in der Lage ist, einen Namen aufzulösen oder zu registrieren, der nicht zu Domänen gehört, für die der Anbieter speziell als primäre oder sekundäre Domäne registriert ist. Wenn dieser Member nichtzero ist, kann der NS_EMAIL Anbieter aufgerufen werden, um eine Adresse aufzulösen oder zu registrieren, wenn kein primärer oder sekundärer Anbieter für die Domäne verfügbar ist.

Es gibt möglicherweise mehrere Anbieter, die behaupten, eine beliebige Adresse auflösen zu können (die fSupportsWildCard ist auf nonzero festgelegt). Wenn es Namespaceanbieter mit diesem Wert gibt, die auch als Feldhalteranbieter registriert sind, werden die Anbieter in der Reihenfolge aufgerufen, in der sie im Winsock-Namespacekatalog angezeigt werden.

cDomains

Art: DWORD

Die Anzahl der NAPI_DOMAIN_DESCRIPTION_BLOB Strukturen ab dem OffsetFirstDomain-Member , das verwendet wird, um Domänen zu beschreiben, die von diesem NS_EMAIL Namespaceanbieter unterstützt werden.

OffsetFirstDomain

Art: DWORD

Der Offset in Bytes auf die erste von mehreren NAPI_DOMAIN_DESCRIPTION_BLOB Strukturen, die zum Beschreiben von Domänen verwendet werden, die von diesem NS_EMAIL Namespaceanbieter unterstützt werden. Dieser Offset muss an einer Mindestgrenze von vier Byte ausgerichtet werden.

Hinweise

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

Die NAPI_PROVIDER_INSTALLATION_BLOB-Struktur enthält die Informationen, die zum Installieren eines Namespaceanbieters für den NS_EMAIL-Namespace erforderlich sind. Möglicherweise gibt es mehrere Namespaceanbieter für die NS_EMAIL Namespaceinstallation auf einem lokalen System.

Jeder im NS_EMAIL-Namespace registrierte Namespaceanbieter kann mehrere Domänen unterstützen. Daher kann es mehrere NAPI_DOMAIN_DESCRIPTION_BLOB-Strukturen in der NAPI_PROVIDER_INSTALLATION_BLOB-Struktur für einen NS_EMAIL-Namespaceanbieter geben. 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 die Autoritätsebene beschreibt, die vom Anbieter für diese Domäne bereitgestellt 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 dieser primäre Anbieter zuerst aufgerufen. Es gibt zwei Fälle, die davon abhängen, ob autorisierende Ergebnisse in der Namespaceabfrage angefordert werden. Die Standardeinstellung für eine Abfrage besteht darin, autorisierende Ergebnisse anzufordern.

Wenn autorisierende Ergebnisse in der Abfrage angefordert werden, werden Namespaceanbieter wie folgt aufgerufen. Wenn der primäre Anbieter nicht verfügbar ist oder die Adresse nicht aufgelöst oder registriert werden kann, wird der erste sekundäre Anbieter im Winsock-Katalog aufgerufen. Wenn der sekundäre Anbieter nicht verfügbar ist oder die Adresse nicht aufgelöst oder registriert werden 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 aufgelöst oder registriert werden können, wird der erste Feldhalteranbieter im Winsock-Katalog aufgerufen. Wenn der erste Feldhalteranbieter nicht verfügbar ist oder die Adresse nicht aufgelöst oder registriert werden kann, wird der nächste Feldhalteranbieter 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 Feldhalteranbieter werden aufgerufen, und die Ergebnisse aller Abfragen werden zurückgegeben. Der primäre Anbieter wird zuerst aufgerufen. Sekundäre Anbieter werden basierend auf der Reihenfolge im Winsock-Katalog als Nächstes aufgerufen. 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 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 alle Namespaceanbieter aufzulisten (einschließlich NS_EMAIL Namespaceanbietern) und die NAPI_PROVIDER_INSTALLATION_BLOB Struktur für einen Anbieter abzurufen, wenn der Anbieter bei der Installation ein Blob registriert hat.

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