Compartir a través de

estructura DNS_QUERY_REQUEST3 (windns.h)

  • Artículo

Contiene los parámetros de consulta DNS usados en una llamada a DnsQueryEx.

Sintaxis

typedef struct _DNS_QUERY_REQUEST3 {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
  BOOL                          IsNetworkQueryRequired;
  DWORD                         RequiredNetworkIndex;
  DWORD                         cCustomServers;
  DNS_CUSTOM_SERVER             *pCustomServers;
} DNS_QUERY_REQUEST3, *PDNS_QUERY_REQUEST3;

Miembros

Version

Tipo: ULONG

La versión de la estructura debe ser la DNS_QUERY_REQUEST_VERSION3; que tiene un valor de 3.

QueryName

Tipo: PCWSTR de

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

Tipo: word

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

Tipo: ULONG64

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

Tipo: PDNS_ADDR_ARRAY

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

InterfaceIndex

Tipo: ULONG

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

Tipo: PDNS_QUERY_COMPLETION_ROUTINE

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 NULL , dnsQueryEx se llama sincrónicamente.

pQueryContext

Tipo: PVOID de

Puntero a un contexto de usuario.

IsNetworkQueryRequired

Tipo: BOOL de

Reservado.

RequiredNetworkIndex

Tipo: DWORD de

Reservado.

cCustomServers

Tipo: DWORD de

Número de servidores personalizados a los que apunta el miembro pCustomServers.

pCustomServers

Tipo: DNS_CUSTOM_SERVER* _Field_size_(cCustomServers)

Puntero a una matriz de N (donde N se proporciona en el campo cCustomServers) DNS_CUSTOM_SERVER objetos.

Si cCustomServers es 0, pCustomServers debe ser NULL.

Nota

Al menos uno de pCustomServers y pDnsServerList debe ser null. Ambos se establecen en valores que noNULL al mismo tiempo no se admiten.

Observaciones

Los servidores personalizados especificados en pCustomServers omitir los servidores DNS configurados por el sistema.

Si el nombre de la consulta coincide con una regla del tabla de directivas de resolución de nombres (NRPT), se omiten los servidores personalizados y solo se usan los servidores de la regla de NRPT.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Build 22000
servidor mínimo admitido Windows Build 22000
encabezado de windns.h

Consulte también