énumération NAPI_PROVIDER_LEVEL (nsemail.h)

Article
02/29/2024

L’énumération NAPI_PROVIDER_LEVEL spécifie le niveau d’autorité du fournisseur d’un fournisseur d’espaces de noms NS_EMAIL pour un domaine donné.

Syntax

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

Constantes


`ProviderLevel_None` Valeur : 0 Le fournisseur d’espaces de noms ne prend pas en charge le domaine actuel. Cette valeur peut être utilisée pour désactiver temporairement la prise en charge d’un domaine sans le supprimer de la liste des domaines pris en charge. Si ProviderLevel_None est défini dans le membre AuthLevel du NAPI_DOMAIN_DESCRIPTION_BLOB pour un domaine donné lorsque le fournisseur est installé et inscrit, le fournisseur d’espaces de noms n’est pas appelé pour résoudre ou inscrire une adresse dans ce domaine, sauf si le fournisseur est inscrit en tant que fournisseur de caractères génériques. Il peut y avoir plusieurs fournisseurs d’espaces de noms NS_EMAIL pour un domaine dont la valeur est ProviderLevel_None. 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 Winsock.
`ProviderLevel_Secondary` Le fournisseur d’espaces de noms est un fournisseur secondaire pour un domaine dans l’espace de noms NS_EMAIL. Un fournisseur d’espaces de noms peut être un fournisseur secondaire dans le domaine cible si le fournisseur peut résoudre et inscrire NS_EMAIL noms pour ce domaine et donner la même réponse qu’un fournisseur principal. Si ProviderLevel_Secondary est défini dans le membre AuthLevel du NAPI_DOMAIN_DESCRIPTION_BLOB pour un domaine donné lorsque le fournisseur est installé et inscrit, ce fournisseur est appelé lorsqu’un fournisseur principal pour le domaine n’est pas actuellement disponible ou que le fournisseur principal n’a pas pu résoudre ou inscrire l’adresse dans ce domaine. Il peut y avoir plusieurs fournisseurs d’espaces de noms NS_EMAIL secondaires pour un domaine avec une valeur de ProviderLevel_Secondary. S’il existe plusieurs fournisseurs d’espaces de noms secondaires, les fournisseurs sont appelés dans l’ordre dans lequel ils apparaissent dans le catalogue Winsock.
`ProviderLevel_Primary` Le fournisseur d’espaces de noms est le fournisseur principal d’un domaine dans l’espace de noms NS_EMAIL. Un fournisseur d’espaces de noms peut prétendre être le fournisseur principal d’un domaine s’il possède tous les noms NS_EMAIL pour ce domaine et a donc accès aux données master pour tous ces noms. Il ne doit y avoir qu’un seul fournisseur d’espace de noms NS_EMAIL principal pour un domaine inscrit sur le système local. Note Il ne doit jamais y avoir deux fournisseurs d’espaces de noms NS_EMAIL qui prétendent être le fournisseur principal pour le même domaine. Si plusieurs fournisseurs tentent de s’inscrire en tant que fournisseur principal pour le même domaine, le premier fournisseur trouvé dans le catalogue d’espaces de noms Winsock pour le domaine en tant que fournisseur principal est appelé. Toutes les autres revendications de fournisseur comme fournisseur principal sont ignorées.

Remarques

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

L’énumération NAPI_PROVIDER_LEVEL est utilisée par la structure NAPI_DOMAIN_DESCRIPTION_BLOB pour spécifier le niveau d’autorité d’un fournisseur d’espace de noms NS_EMAIL pour un domaine. Chaque fournisseur d’espace 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 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 type de prise en charge fournie par le fournisseur pour ce domaine.

En plus du domaine spécifié, un fournisseur d’espaces de noms NS_EMAIL peut également s’inscrire en tant que fournisseur de caractères génériques pour essayer de prendre en charge n’importe quel domaine, en spécifiant le membre fSupportsWildCard comme différent de zéro dans le NAPI_PROVIDER_INSTALLATION_BLOB passé lors de l’installation du fournisseur.

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.

La structure NAPI_DOMAIN_DESCRIPTION_BLOB est utilisée dans la structure NAPI_PROVIDER_INSTALLATION_BLOB pour décrire un fournisseur d’espaces de noms NS_EMAIL.

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 les fournisseurs d’espaces de noms pour l’espace de noms NS_EMAIL et récupérer la structure NAPI_PROVIDER_INSTALLATION_BLOB d’un fournisseur.

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