estructura DNS_QUERY_RESULT (windns.h)

Una estructura de DNS_QUERY_RESULT contiene los resultados de la consulta DNS devueltos desde una llamada a DnsQueryEx.

Sintaxis

typedef struct _DNS_QUERY_RESULT {
  ULONG       Version;
  DNS_STATUS  QueryStatus;
  ULONG64     QueryOptions;
  PDNS_RECORD pQueryRecords;
  PVOID       Reserved;
} DNS_QUERY_RESULT, *PDNS_QUERY_RESULT;

Miembros

Version

La versión de la estructura debe ser una de las siguientes:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

Estado devuelto de la llamada a DnsQueryEx.

Si la consulta se completó de forma asincrónica y esta estructura se devolvió directamente desde DnsQueryEx, queryStatus contiene DNS_REQUEST_PENDING.

Si la consulta se completó de forma sincrónica o si la devolución de llamada de DNS DNS_QUERY_COMPLETION_ROUTINE devolvió esta estructura, queryStatus contiene ERROR_SUCCESS si se ejecuta correctamente o el código de error específico de DNS adecuado, tal como se define en Winerror.h.

QueryOptions

Valor que contiene un mapa de bits de opciones de consulta dns que se usaron en la consulta DNS. Las opciones se pueden combinar y todas las opciones invalidan DNS_QUERY_STANDARD

pQueryRecords

Puntero a una estructura DNS_RECORD.

Si la consulta se completó de forma asincrónica y esta estructura se devolvió directamente desde DnsQueryEx, pQueryRecords es NULL.

Si la consulta se completó de forma sincrónica o si el DNS_QUERY_COMPLETION_ROUTINE devolución de llamada DNS devolvió esta estructura, pQueryRecords contiene una lista de registros de recursos (RR) que componen la respuesta.

Note Applications debe devolver gratis los conjuntos RR con la función DnsRecordListFree.

 

Reserved

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8 [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2012 [solo aplicaciones de escritorio]
encabezado de	windns.h

Consulte también

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST