Freigeben über

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;

Angehörige

Version

Typ: ULONG-

Die Strukturversion muss die DNS_QUERY_REQUEST_VERSION3sein; die einen Wert von 3 aufweist.

QueryName

Typ: PCWSTR-

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

Anmerkung

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

QueryType

Typ: WORD-

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 wType-DNS_TYPE_Aist, wird das Format der Daten, auf die von pQueryRecords verwiesen wird, DNS_A_DATA.

QueryOptions

Typ: ULONG64

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

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- 0 ist, 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 DnsQueryExzurückzugeben.

Anmerkung

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 vom pCustomServers Member verwiesen wird.

pCustomServers

Typ: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

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

Wenn cCustomServers 0 ist, muss pCustomServersNULL-sein.

Anmerkung

Mindestens einer der pCustomServers und pDnsServerList- muss NULL-sein. Beide werte werden nichtNULL- gleichzeitig festgelegt, werden nicht unterstützt.

Bemerkungen

Die in pCustomServers angegebenen benutzerdefinierten Server umgehen die vom System konfigurierten DNS-Server.

Wenn der Abfragename einer Regel in der NRPT-(Name Resolution Policy Table) entspricht, werden die benutzerdefinierten Server ignoriert, und nur die Server aus der NRPT- Regel werden verwendet.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Build 22000
mindestens unterstützte Server- Windows Build 22000
Header- windns.h

Siehe auch