NAPI_DOMAIN_DESCRIPTION_BLOB-Struktur (nsemail.h)

Die NAPI_DOMAIN_DESCRIPTION_BLOB-Struktur beschreibt eine Domäne, die von einem Namespaceanbieter für den NS_EMAIL-Namespace behandelt wird.

Syntax

typedef struct napi_domain_description_blob_tag {
  DWORD AuthLevel;
  DWORD cchDomainName;
  DWORD OffsetNextDomainDescription;
  DWORD OffsetThisDomainName;
} NAPI_DOMAIN_DESCRIPTION_BLOB;

Member

AuthLevel

Die Autoritätsebene des Namespaceanbieters für diese Domäne. Dieser Member kann einer der Werte aus dem NAPI_PROVIDER_LEVEL Enumerationstyp sein, der in der Headerdatei Nsemail.h definiert ist.

cchDomainName

Die Länge in Unicode-Zeichen der Unicode-Zeichenfolge, die den Domänennamen enthält, der durch das OffsetThisDomainName-Element dargestellt wird. Der NULL-Abschlusszeichen wird beim Berechnen der Länge nicht gezählt.

OffsetNextDomainDescription

Der Offset in Byte zur nächsten NAPI_DOMAIN_DESCRIPTION_BLOB-Struktur in der NAPI_PROVIDER_INSTALLATION_BLOB-Struktur .

OffsetThisDomainName

Der Offset in Byte zu einer Unicode-Zeichenfolge, die einen Domänennamen enthält, der von diesem Namespaceanbieter für den NS_EMAIL Namespace behandelt wird. Der Domänenname muss mindestens cchDomainName Unicode-Zeichen lang sein. Die NULL-Beendigung der Unicode-Zeichenfolge, die den Domänennamen enthält, wird empfohlen, ist jedoch nicht erforderlich. Dieser Offset muss mindestens an einer Zwei-Byte-Grenze ausgerichtet werden.

Hinweise

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

Die NAPI_DOMAIN_DESCRIPTION_BLOB-Struktur beschreibt eine Domäne, die von einem Namespaceanbieter für den NS_EMAIL-Namespace behandelt wird. Ein typischer Domänenname, der durch das OffsetThisDomainName-Element in dieser Struktur dargestellt wird, kann msn.com oder yahoo.com sein.

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.

Die NAPI_DOMAIN_DESCRIPTION_BLOB-Struktur ist ein Member der NAPI_PROVIDER_INSTALLATION_BLOB-Struktur , die zum Beschreiben und Registrieren eines NS_EMAIL-Namespaceanbieters verwendet wird. In der NAPI_PROVIDER_INSTALLATION_BLOB-Struktur für einen NS_EMAIL-Namespaceanbieter können mehrere NAPI_DOMAIN_DESCRIPTION_BLOB-Strukturen vorhanden sein.

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 (einschließlich NS_EMAIL Namespaceanbieter) aufzulisten 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

Weitere Informationen

NAPI_PROVIDER_INSTALLATION_BLOB

NAPI_PROVIDER_LEVEL

WSAEnumNameSpaceProvidersEx

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32