estructura DNS_QUERY_REQUEST3 (windns.h)
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
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 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, se DNS_A_DATA el formato de los datos a los que apunta pQueryRecords.
QueryOptions
Tipo: ULONG64
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
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 en 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 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, Se llama a DnsQueryEx de forma sincrónica.
pQueryContext
Tipo: PVOID
Puntero a un contexto de usuario.
IsNetworkQueryRequired
Tipo: BOOL
Reservado.
RequiredNetworkIndex
Tipo: DWORD
Reservado.
cCustomServers
Tipo: DWORD
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 no son NULL al mismo tiempo que no se admiten.
Comentarios
Los servidores personalizados especificados en pCustomServers omiten los servidores DNS configurados por el sistema.
Si el nombre de la consulta coincide con una regla en la tabla de directivas de resolución de nombres (NRPT), se omiten los servidores personalizados y solo se usan los servidores de la regla NRPT .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compilación 22000 de Windows |
| Servidor mínimo compatible | Compilación 22000 de Windows |
| Encabezado | windns.h |