Compartir a través de


Función DnsValidateServerStatus (windns.h)

La función DnsValidateServerStatus valida una dirección IP como un servidor DNS adecuado.

Sintaxis

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

Parámetros

[in] server

Puntero a un SOCKADDR que contiene la dirección IPv4 o IPv6 del servidor DNS que se va a examinar.

[in] queryName

Puntero a una cadena Unicode que representa el nombre de dominio completo (FQDN) del propietario del conjunto de registros que se consulta.

[out] serverStatus

Puntero a un DWORD que representa el estado de validación de la consulta.

Value Significado
ERROR_SUCCESS
No hay errores. La llamada se realizó correctamente.
DNS_VALSVR_ERROR_INVALID_ADDR
Servidor La dirección IP no era válida.
DNS_VALSVR_ERROR_INVALID_NAME
queryName FQDN no era válido.
DNS_VALSVR_ERROR_UNREACHABLE
No se pudo acceder al servidor DNS.
DNS_VALSVR_ERROR_NO_RESPONSE
Tiempo de espera en espera de la respuesta del servidor DNS.
DNS_VALSVR_ERROR_NO_AUTH
No se encontró el servidor DNS autoritativo o queryName .
DNS_VALSVR_ERROR_REFUSED
El servidor DNS rechazó la consulta.
DNS_VALSVR_ERROR_NO_TCP
La consulta TCP no devolvió ERROR_SUCCESS después de que el sistema de validación ya hubiera completado una consulta correcta en el servidor DNS mediante UDP.
DNS_VALSVR_ERROR_UNKNOWN
Se produjo un error desconocido.

Valor devuelto

La función DnsValidateServerStatus tiene los siguientes valores devueltos posibles:

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado windns.h
Library Dnsapi.lib
Archivo DLL Dnsapi.dll

Consulte también

Funciones DNS