DnsValidateName_W, fonction (windns.h)

  • Article

La fonction DnsValidateName valide la status d’un nom DNS spécifié. Comme de nombreuses fonctions DNS, le type de fonction DnsValidateName est implémenté sous plusieurs formes pour faciliter l’encodage de caractères différents. En fonction de l’encodage de caractères impliqué, utilisez l’une des fonctions suivantes :

  • DnsValidateName_A (_A pour l’encodage ANSI)
  • DnsValidateName_W (_W pour l’encodage Unicode)
  • DnsValidateName_UTF8 (_UTF8 pour l’encodage UTF-8)

Syntaxe

DNS_STATUS DnsValidateName_W(
  [in] PCWSTR          pszName,
  [in] DNS_NAME_FORMAT Format
);

Paramètres

[in] pszName

Pointeur vers une chaîne qui représente le nom DNS à examiner.

[in] Format

Valeur DNS_NAME_FORMAT qui spécifie le format du nom à examiner.

Valeur retournée

La fonction DnsValidateName a les valeurs de retour possibles suivantes :

Remarques

Pour vérifier la status de l’hôte de l’ordinateur (étiquette unique), utilisez le type de fonction DnsValidateName avec DnsNameHostnameLabel au format.

La fonction DnsValidateName fonctionne dans une progression lors de la détermination de l’existence d’une erreur avec un nom DNS donné, et retourne une fois sa première erreur trouvé. Par conséquent, un nom DNS qui comporte plusieurs erreurs différentes peut être signalé comme ayant la première erreur, et peut être corrigé et soumis à nouveau, puis pour trouver la deuxième erreur.

La fonction DnsValidateName recherche les erreurs comme suit :

  1. Retourne ERROR_INVALID_NAME si le nom DNS :
    • Est plus long que 255 octets.
    • Contient une étiquette de plus de 63 octets.
    • Contient au moins deux points consécutifs.
    • Commence par un point (.).
    • Contient un point (.) si le nom est envoyé avec Format défini sur DnsNameDomainLabel ou DnsNameHostnameLabel.
  2. Ensuite, DnsValidateName renvoie DNS_ERROR_NUMERIC_NAME si le nom DNS complet se compose uniquement de caractères numériques (0-9) ou si la première étiquette du nom DNS se compose uniquement de caractères numériques (0-9), sauf si Format est défini sur DnsNameDomainLabel ou DnsNameDomain.
  3. Ensuite, DnsValidateName retourne DNS_ERROR_NON_RFC_NAME si le nom DNS :
    • Contient au moins un caractère étendu ou Unicode. Remarque Windows 8 ou version ultérieure : DnsValidateName_W ne retourne pas d’erreur si l’encodage de nom de domaine international (IDN) est activé.
    • Contient un trait de soulignement (_), sauf si le trait de soulignement est un premier caractère dans une étiquette, dans le nom, envoyé avec Format défini sur DnsNameSrvRecord.
  4. Ensuite, DnsValidateName retourne DNS_ERROR_INVALID_NAME_CHAR si le nom DNS :
    • Contient un espace.
    • Contient l’un des caractères non valides suivants : { | } ~ [ \ ] ^ ' : ; < = > ? & @ ! " # $ % ^ ` ( ) + / ,
    • Contient un astérisque (*), sauf si l’astérisque est la première étiquette du nom multiétiqueté, envoyée avec format défini sur DnsNameWildcard.
Note Si DnsValidateName renvoie DNS_ERROR_NON_RFC_NAME, l’erreur doit être gérée comme un avertissement indiquant que tous les serveurs DNS n’acceptent pas le nom. Lorsque cette erreur est reçue, notez que le serveur DNS accepte le nom envoyé, s’il est correctement configuré (la configuration par défaut accepte le nom envoyé lorsque DNS_ERROR_NON_RFC_NAME est retourné), mais que d’autres logiciels serveur DNS ne peuvent pas le faire. Les serveurs DNS Windows gèrent NON_RFC_NAMES.

Si DnsValidateName renvoie l’une des erreurs suivantes, pszName doit être géré comme un nom d’hôte non valide :

DNS_ERROR_NUMERIC_NAME
DNS_ERROR_INVALID_NAME_CHAR
ERROR_INVALID_NAME
 

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête windns.h
Bibliothèque Dnsapi.lib
DLL Dnsapi.dll

Voir aussi

DNS_NAME_FORMAT

DNS_RECORD

DnsNameCompare

DnsQuery