Export (0) Print
Expand All

DNS_QUERY_REQUEST structure

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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Windns.h

See also

DnsCancelQuery
DnsQuery
DnsQueryEx
DNS_QUERY_COMPLETION_ROUTINE
DNS_QUERY_CANCEL
DNS_QUERY_RESULT

 

 

Community Additions

ADD
Show:
© 2014 Microsoft