structure NAPI_DOMAIN_DESCRIPTION_BLOB (nsemail.h)

Article
08/25/2023

La structure NAPI_DOMAIN_DESCRIPTION_BLOB décrit un domaine géré par un fournisseur d’espace de noms pour l’espace de noms NS_EMAIL.

Syntaxe

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

Membres

AuthLevel

Niveau d’autorité du fournisseur d’espaces de noms pour ce domaine. Ce membre peut être l’une des valeurs du type d’énumération NAPI_PROVIDER_LEVEL défini dans le fichier d’en-tête Nsemail.h .

cchDomainName

Longueur, en caractères Unicode, de la chaîne Unicode qui contient le nom de domaine représenté par le membre OffsetThisDomainName . La terminaison NULL n’est pas comptabilisée lors du calcul de la longueur.

OffsetNextDomainDescription

Décalage, en octets, de la structure NAPI_DOMAIN_DESCRIPTION_BLOB suivante dans la structure NAPI_PROVIDER_INSTALLATION_BLOB .

OffsetThisDomainName

Décalage, en octets, vers une chaîne Unicode qui contient un nom de domaine géré par ce fournisseur d’espace de noms pour l’espace de noms NS_EMAIL. Le nom de domaine doit comporter au moins des caractères Unicode cchDomainName . L’arrêt NULL de la chaîne Unicode qui contient le nom de domaine est recommandé, mais pas obligatoire. Ce décalage doit être aligné sur au moins une limite de deux octets.

Remarques

Cette structure est prise en charge sur Windows Vista et versions ultérieures.

La structure NAPI_DOMAIN_DESCRIPTION_BLOB décrit un domaine géré par un fournisseur d’espace de noms pour l’espace de noms NS_EMAIL. Un nom de domaine typique représenté par le membre OffsetThisDomainName dans cette structure peut être msn.com ou yahoo.com.

Chaque fournisseur d’espaces de noms inscrit dans l’espace de noms NS_EMAIL peut prendre en charge plusieurs domaines. La liste des domaines pris en charge est spécifiée dans l’objet blob d’inscription du fournisseur sous la forme d’une liste de structures NAPI_DOMAIN_DESCRIPTION_BLOB . Chaque spécification de domaine prise en charge contient une valeur NAPI_PROVIDER_LEVEL dans le membre AuthLevel du NAPI_DOMAIN_DESCRIPTION_BLOB qui décrit le type de prise en charge fournie par le fournisseur pour ce domaine.

La structure NAPI_DOMAIN_DESCRIPTION_BLOB est membre de la structure NAPI_PROVIDER_INSTALLATION_BLOB utilisée pour décrire et inscrire un fournisseur d’espace de noms NS_EMAIL. Il peut y avoir plusieurs structures NAPI_DOMAIN_DESCRIPTION_BLOB dans la structure NAPI_PROVIDER_INSTALLATION_BLOB pour un fournisseur d’espace de noms NS_EMAIL.

Les fonctions WSCInstallNameSpaceEx et WSCInstallNameSpaceEx32 sont utilisées pour installer un fournisseur d’espaces de noms pour l’espace de noms NS_EMAIL à l’aide d’une structure NAPI_PROVIDER_INSTALLATION_BLOB .

Les fonctions WSAEnumNameSpaceProvidersEx et WSCEnumNameSpaceProvidersEx32 permettent d’énumérer tous les fournisseurs d’espaces de noms (y compris NS_EMAIL fournisseurs d’espaces de noms) et de récupérer la structure NAPI_PROVIDER_INSTALLATION_BLOB d’un fournisseur si le fournisseur a inscrit un objet blob lors de l’installation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	nsemail.h