DNS_QUERY_REQUEST3-Struktur (windns.h)

  • Artikel

Enthält die DNS-Abfrageparameter, die in einem Aufruf von DnsQueryEx verwendet werden.

Syntax

typedef struct _DNS_QUERY_REQUEST3 {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
  BOOL                          IsNetworkQueryRequired;
  DWORD                         RequiredNetworkIndex;
  DWORD                         cCustomServers;
  DNS_CUSTOM_SERVER             *pCustomServers;
} DNS_QUERY_REQUEST3, *PDNS_QUERY_REQUEST3;

Member

Version

Typ: ULONG

Die Strukturversion muss die DNS_QUERY_REQUEST_VERSION3 sein. der den Wert 3 aufweist.

QueryName

Typ: PCWSTR

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

Hinweis

Wenn QueryNameNULL ist, gilt die Abfrage für den Namen des lokalen Computers.

QueryType

Typ: WORD

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 pQueryRecords verweist, DNS_A_DATA.

QueryOptions

Typ: ULONG64

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

Typ: PDNS_ADDR_ARRAY

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

InterfaceIndex

Typ: ULONG

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

pQueryCompletionCallback

Typ: PDNS_QUERY_COMPLETION_ROUTINE

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

Wenn NULL, wird DnsQueryEx synchron aufgerufen.

pQueryContext

Typ: PVOID

Ein Zeiger auf einen Benutzerkontext.

IsNetworkQueryRequired

Typ: BOOL

Reserviert.

RequiredNetworkIndex

Typ: DWORD

Reserviert.

cCustomServers

Typ: DWORD

Die Anzahl der benutzerdefinierten Server, auf die der pCustomServers-Member verweist.

pCustomServers

Typ: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

Ein Zeiger auf ein Array von N (wobei N im Feld cCustomServers angegeben wird) DNS_CUSTOM_SERVER -Objekten.

Wenn cCustomServers den Wert 0 aufweist, muss pCustomServersNULL sein.

Hinweis

Mindestens einer von pCustomServers und pDnsServerList muss NULL sein. Beide Werte, die gleichzeitig auf Werte ungleich NULL festgelegt sind, werden nicht unterstützt.

Hinweise

Die in pCustomServers angegebenen benutzerdefinierten Server umgehen die systemkonfigurierten DNS-Server.

Wenn der Abfragename mit einer Regel in der Richtlinientabelle für die Namensauflösung (Name Resolution Policy Table, NRPT) übereinstimmt, werden die benutzerdefinierten Server ignoriert, und es werden nur die Server aus der NRPT-Regel verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Build 22000
Unterstützte Mindestversion (Server) Windows Build 22000
Kopfzeile windns.h

Weitere Informationen