DNS_QUERY_REQUEST structure (windns.h)

The DNS_QUERY_REQUEST structure contains the DNS query parameters used in a call to DnsQueryEx.

Syntax

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;

Members

Version

The structure version must be one of the following:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

A pointer to a string that represents the DNS name to query.

Note  If QueryName is NULL, the query is for the local machine name.
 

QueryType

A value that represents the Resource Record (RR) DNS Record Type that is queried. QueryType determines the format of data pointed to by pQueryRecords returned in the DNS_QUERY_RESULT structure. For example, if the value of wType is DNS_TYPE_A, the format of data pointed to by pQueryRecords is DNS_A_DATA.

QueryOptions

A value that contains a bitmap of DNS Query Options to use in the DNS query. Options can be combined and all options override DNS_QUERY_STANDARD

pDnsServerList

A pointer to a DNS_ADDR_ARRAY structure that contains a list of DNS servers to use in the query.

InterfaceIndex

A value that contains the interface index over which the query is sent. If InterfaceIndex is 0, all interfaces will be considered.

pQueryCompletionCallback

A pointer to a DNS_QUERY_COMPLETION_ROUTINE callback that is used to return the results of an asynchronous query from a call to DnsQueryEx.

Note  If NULL, DnsQueryEx is called synchronously.
 

pQueryContext

A pointer to a user context.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header windns.h

See also

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_RESULT

DnsCancelQuery

DnsQuery

DnsQueryEx