Funzione DnsValidateServerStatus (windns.h)

La funzione DnsValidateServerStatus convalida un indirizzo IP come server DNS appropriato.

Sintassi

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

[in] server

Puntatore a un SOCKADDR contenente l'indirizzo IPv4 o IPv6 del server DNS da esaminare.

[in] queryName

Puntatore a una stringa Unicode che rappresenta il nome di dominio completo (FQDN) del proprietario del set di record sottoposto a query.

[out] serverStatus

Puntatore a un DWORD che rappresenta lo stato di convalida della query.

Valore	Significato
ERROR_SUCCESS	Nessun errore. La chiamata è stata completata correttamente.
DNS_VALSVR_ERROR_INVALID_ADDR	Server Indirizzo IP non valido.
DNS_VALSVR_ERROR_INVALID_NAME	queryName FQDN non è valido.
DNS_VALSVR_ERROR_UNREACHABLE	Il server DNS non è raggiungibile.
DNS_VALSVR_ERROR_NO_RESPONSE	Timeout in attesa della risposta del server DNS.
DNS_VALSVR_ERROR_NO_AUTH	Il server DNS non è stato trovato o queryName non è stato trovato.
DNS_VALSVR_ERROR_REFUSED	Il server DNS ha rifiutato la query.
DNS_VALSVR_ERROR_NO_TCP	La query TCP non ha restituito ERROR_SUCCESS dopo che il sistema di convalida ha già completato una query riuscita al server DNS usando UDP.
DNS_VALSVR_ERROR_UNKNOWN	Si è verificato un errore sconosciuto.

La funzione DnsValidateServerStatus include i valori restituiti seguenti:


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	Dnsapi.lib
DLL	Dnsapi.dll