estructura DNS_QUERY_REQUEST (windns.h)

Artículo
08/27/2023

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 tipo de registro DNS de registro de recursos (RR) que se consulta. QueryType determina el formato de los datos a los que apunta pQueryRecords devueltos en la estructura 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 las opciones de consulta de DNS que se van a 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 un DNS_QUERY_COMPLETION_ROUTINE devolución de llamada que se usa para devolver los resultados de una consulta asincrónica desde una llamada a DnsQueryEx.

Nota Si es NULL, DnsQueryEx se llama de forma sincrónica.

pQueryContext

Puntero a un contexto de usuario.

Requisitos


Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	windns.h