DNS_QUERY_REQUEST Struktur (windns.h)

Artikel
08/27/2023

Die DNS_QUERY_REQUEST-Struktur enthält die DNS-Abfrageparameter, die in einem Aufruf von DnsQueryEx verwendet werden.

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;

Member

Version

Die Strukturversion muss eine der folgenden Sein:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

Ein Zeiger auf eine Zeichenfolge, die den abzufragenden DNS-Namen darstellt.

Hinweis Wenn QueryName NULL ist, ist die Abfrage für den namen des lokalen Computers.

QueryType

Ein Wert, der den abgefragten DNS-Eintragstyp Resource Record (RR) darstellt. QueryType bestimmt das Format der Daten, auf das von pQueryRecords verwiesen wird, die in der DNS_QUERY_RESULT-Struktur zurückgegeben werden. Wenn der Wert von wType beispielsweise DNS_TYPE_A ist, wird das Format der Daten, auf das von pQueryRecords verwiesen wird , DNS_A_DATA.

QueryOptions

Ein Wert, der eine Bitmap der DNS-Abfrageoptionen enthält, die in der DNS-Abfrage verwendet werden sollen. Optionen können kombiniert werden, und alle Optionen überschreiben DNS_QUERY_STANDARD

pDnsServerList

Ein Zeiger auf eine DNS_ADDR_ARRAY-Struktur , die eine Liste der DNS-Server enthält, die in der Abfrage verwendet werden sollen.

InterfaceIndex

Ein Wert, der den Schnittstellenindex enthält, über den die Abfrage gesendet wird. Wenn InterfaceIndex 0 ist, werden alle Schnittstellen berücksichtigt.

pQueryCompletionCallback

Ein Zeiger auf einen DNS_QUERY_COMPLETION_ROUTINE Rückruf, der verwendet wird, um die Ergebnisse einer asynchronen Abfrage aus einem Aufruf von DnsQueryEx zurückzugeben.

Hinweis Bei NULL wird DnsQueryEx synchron aufgerufen.

pQueryContext

Ein Zeiger auf einen Benutzerkontext.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	windns.h