Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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


Feedback

Was this page helpful?

Additional resources