NAPI_PROVIDER_INSTALLATION_BLOB structure (nsemail.h)

Article
08/25/2023

La structure NAPI_PROVIDER_INSTALLATION_BLOB contient les informations nécessaires à l’installation d’un fournisseur d’espaces de noms pour l’espace de noms NS_EMAIL.

Syntaxe

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

Membres

dwVersion

Type : DWORD

Numéro de version du fournisseur d’espace de noms NS_EMAIL. Ce membre est spécifique au fournisseur d’espaces de noms.

dwProviderType

Type : DWORD

Type de fournisseur d’espace de noms pour l’espace de noms NS_EMAIL. Ce membre peut être l’une des valeurs du type d’énumération NAPI_PROVIDER_TYPE défini dans le fichier d’en-tête Nsemail.h .

fSupportsWildCard

Type : DWORD

Valeur booléenne qui indique si cette NS_EMAIL fournisseur d’espaces de noms prend en charge les noms génériques. Si ce membre est différent de zéro, un fournisseur de NS_EMAIL prétend être potentiellement en mesure de résoudre ou d’inscrire un nom qui n’appartient à aucun domaine pour lequel le fournisseur est spécifiquement inscrit en tant que principal ou secondaire. Si ce membre est différent de zéro, le fournisseur de NS_EMAIL peut être appelé pour résoudre ou inscrire une adresse, si aucun fournisseur principal ou secondaire pour le domaine n’est disponible.

Il peut y avoir plusieurs fournisseurs qui prétendent pouvoir résoudre n’importe quelle adresse (la fSupportsWildCard définie sur une valeur différente de zéro). S’il existe des fournisseurs d’espaces de noms avec cette valeur qui sont également inscrits en tant que fournisseur de caractères génériques, les fournisseurs sont appelés dans l’ordre dans lequel ils apparaissent dans le catalogue d’espaces de noms Winsock.

cDomains

Type : DWORD

Nombre de structures NAPI_DOMAIN_DESCRIPTION_BLOB commençant par le membre OffsetFirstDomain utilisé pour décrire les domaines pris en charge par ce fournisseur d’espaces de noms NS_EMAIL.

OffsetFirstDomain

Type : DWORD

Décalage, en octets, de la première des plusieurs structures NAPI_DOMAIN_DESCRIPTION_BLOB utilisées pour décrire les domaines pris en charge par ce fournisseur d’espaces de noms NS_EMAIL. Ce décalage doit être aligné sur une limite minimale de quatre octets.

Remarques

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

La structure NAPI_PROVIDER_INSTALLATION_BLOB contient les informations nécessaires à l’installation d’un fournisseur d’espaces de noms pour l’espace de noms NS_EMAIL. Il peut y avoir plusieurs fournisseurs d’espaces de noms pour l’installation de l’espace de noms NS_EMAIL sur un système local.

Chaque fournisseur d’espace de noms inscrit dans l’espace de noms NS_EMAIL peut prendre en charge plusieurs domaines. Par conséquent, il peut y avoir plusieurs structures NAPI_DOMAIN_DESCRIPTION_BLOB dans la structure NAPI_PROVIDER_INSTALLATION_BLOB pour un fournisseur d’espaces de noms NS_EMAIL. La liste des domaines pris en charge est spécifiée dans l’objet blob d’inscription de 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 niveau d’autorité fourni par le fournisseur pour ce domaine.

Les fournisseurs d’espaces de noms sont appelés dans l’ordre suivant pour résoudre ou inscrire une adresse dans un domaine. Si un fournisseur d’espace de noms inscrit en tant que fournisseur principal pour le domaine, ce fournisseur principal est appelé en premier. Il existe deux cas selon que des résultats faisant autorité sont demandés ou non dans la requête d’espace de noms. La valeur par défaut d’une requête consiste à demander des résultats faisant autorité.

Lorsque des résultats faisant autorité sont demandés dans la requête, les fournisseurs d’espaces de noms sont appelés comme suit. Si le fournisseur principal n’est pas disponible ou ne peut pas résoudre ou inscrire l’adresse, le premier fournisseur secondaire du catalogue Winsock est appelé. Si le fournisseur secondaire n’est pas disponible ou ne peut pas résoudre ou inscrire l’adresse, le fournisseur secondaire suivant dans le catalogue Winsock est appelé. Si tous les fournisseurs secondaires ne sont pas disponibles ou ne peuvent pas résoudre ou inscrire l’adresse, le premier fournisseur de caractères génériques dans le catalogue Winsock est appelé. Si le premier fournisseur de caractères génériques n’est pas disponible ou ne peut pas résoudre ou inscrire l’adresse, le fournisseur de caractères génériques suivant dans le catalogue Winsock est appelé.

Lorsque des résultats non faisant autorité sont demandés dans la requête, les fournisseurs d’espaces de noms sont appelés comme suit. Le fournisseur principal, tous les fournisseurs secondaires et tous les fournisseurs de caractères génériques sont appelés et les résultats de toutes les requêtes sont retournés. Le fournisseur principal est appelé en premier. Les fournisseurs secondaires sont appelés suivant, en fonction de l’ordre dans le catalogue Winsock. Les fournisseurs de caractères génériques sont appelés suivant, en fonction de l’ordre dans le catalogue Winsock. Les résultats retournés sont basés sur l’ordre des requêtes.

Les fonctions WSCInstallNameSpaceEx et WSCInstallNameSpaceEx32 permettent d’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 sont utilisées pour énumérer tous les fournisseurs d’espaces de noms (y compris NS_EMAIL fournisseurs d’espaces de noms) et pour 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