estructura DNS_QUERY_REQUEST (windns.h)

La estructura DNS_QUERY_REQUEST contiene los parámetros de consulta DNS usados en una llamada a DnsQueryEx.

Sintaxis

typedef struct _DNS_QUERY_REQUEST {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
} DNS_QUERY_REQUEST, *PDNS_QUERY_REQUEST;

Miembros

Version

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

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

Puntero a una cadena que representa el nombre DNS que se va a consultar.

Nota Si queryName es NULL, la consulta es para el nombre del equipo local.

 

QueryType

Valor que representa el registro de recursos (RR) tipo de registro DNS que se consulta. QueryType determina el formato de los datos a los que apunta pQueryRecords devueltos en la estructura de DNS_QUERY_RESULT. Por ejemplo, si el valor de wType es DNS_TYPE_A, el formato de los datos a los que apunta pQueryRecords es DNS_A_DATA.

QueryOptions

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

pDnsServerList

Puntero a una estructura de DNS_ADDR_ARRAY que contiene una lista de servidores DNS que se van a usar en la consulta.

InterfaceIndex

Valor que contiene el índice de interfaz sobre el que se envía la consulta. Si InterfaceIndex es 0, se considerarán todas las interfaces.

pQueryCompletionCallback

Puntero a una devolución de llamada de DNS_QUERY_COMPLETION_ROUTINE que se usa para devolver los resultados de una consulta asincrónica desde una llamada a DnsQueryEx.

Nota Si ES NULL, DnsQueryEx se denomina sincrónicamente.

 

pQueryContext

Puntero a un contexto de usuario.

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_RESULT

dnsCancelQuery de

dnsQuery

DnsQueryEx