DnsValidateName_UTF8, fonction (windns.h)

Article
03/04/2024

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_UTF8(
  [in] PCSTR           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 l’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 d’une erreur avec un nom DNS donné et retourne sa première erreur. 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 trouver la deuxième erreur.

La fonction DnsValidateName recherche les erreurs comme suit :

Retourne ERROR_INVALID_NAME si le nom DNS :
- Est plus long que 255 octets.
- Contient une étiquette supérieure à 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.
Ensuite, DnsValidateName retourne 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.
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 IDN (International Domain Name) 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.
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 à étiquettes multiples, envoyée avec format défini sur DnsNameWildcard.

Note Si DnsValidateName retourne 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 configuré de manière appropriée (la configuration par défaut accepte le nom envoyé lorsque DNS_ERROR_NON_RFC_NAME est retourné), mais que d’autres logiciels serveur DNS peuvent ne pas le faire. Les serveurs DNS Windows gèrent NON_RFC_NAMES.

Si DnsValidateName retourne 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

Condition requise	Valeur
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

Partager via