DnsValidateServerStatus, fonction (windns.h)

La fonction DnsValidateServerStatus valide une adresse IP en tant que serveur DNS approprié.

Syntaxe

DNS_STATUS DnsValidateServerStatus(
  [in]  PSOCKADDR server,
  [in]  PCWSTR    queryName,
  [out] PDWORD    serverStatus
);

[in] server

Pointeur vers un SOCKADDR qui contient l’adresse IPv4 ou IPv6 du serveur DNS à examiner.

[in] queryName

Pointeur vers une chaîne Unicode qui représente le nom de domaine complet (FQDN) du propriétaire du jeu d’enregistrements interrogé.

[out] serverStatus

Pointeur vers un DWORD qui représente le status de validation de requête.

Valeur	Signification
ERROR_SUCCESS	Aucune erreur. L’appel a réussi.
DNS_VALSVR_ERROR_INVALID_ADDR	Serveur L’adresse IP n’était pas valide.
DNS_VALSVR_ERROR_INVALID_NAME	queryName Le nom de domaine complet n’était pas valide.
DNS_VALSVR_ERROR_UNREACHABLE	Le serveur DNS était inaccessible.
DNS_VALSVR_ERROR_NO_RESPONSE	Délai d’attente pour la réponse du serveur DNS.
DNS_VALSVR_ERROR_NO_AUTH	Le serveur DNS n’a pas fait autorité ou queryName est introuvable.
DNS_VALSVR_ERROR_REFUSED	Le serveur DNS a refusé la requête.
DNS_VALSVR_ERROR_NO_TCP	La requête TCP n’a pas retourné ERROR_SUCCESS une fois que le système de validation a déjà effectué une requête réussie sur le serveur DNS à l’aide d’UDP.
DNS_VALSVR_ERROR_UNKNOWN	Une erreur inconnue s'est produite.

La fonction DnsValidateServerStatus a les valeurs de retour possibles suivantes :


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