DNS_QUERY_REQUEST Struktur (windns.h)

Artikel
11/08/2024

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;

Angehörige

Version

Die Strukturversion muss eine der folgenden Sein:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

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

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

QueryType

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

QueryOptions

Ein Wert, der eine Bitmap 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 DnsQueryExzurückzugeben.

Hinweis Wenn NULL, wird DnsQueryEx- synchron aufgerufen.

pQueryContext

Ein Zeiger auf einen Benutzerkontext.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2012 [nur Desktop-Apps]
Header-	windns.h

Siehe auch

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

Freigeben über