DNS_QUERY_RESULT Struktur (windns.h)

Artikel
01/16/2025

Eine DNS_QUERY_RESULT Struktur enthält die DNS-Abfrageergebnisse, die von einem Aufruf an DnsQueryExzurückgegeben werden.

Syntax

typedef struct _DNS_QUERY_RESULT {
  ULONG       Version;
  DNS_STATUS  QueryStatus;
  ULONG64     QueryOptions;
  PDNS_RECORD pQueryRecords;
  PVOID       Reserved;
} DNS_QUERY_RESULT, *PDNS_QUERY_RESULT;

Angehörige

Version

Die Strukturversion muss eine der folgenden Sein:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

Der Rückgabestatus des Aufrufs von DnsQueryEx.

Wenn die Abfrage asynchron abgeschlossen wurde und diese Struktur direkt von DnsQueryExzurückgegeben wurde, enthält QueryStatus-DNS_REQUEST_PENDING.

Wenn die Abfrage synchron abgeschlossen wurde oder diese Struktur vom DNS_QUERY_COMPLETION_ROUTINE DNS-Rückruf zurückgegeben wurde, enthält QueryStatus- ERROR_SUCCESS, wenn erfolgreich oder der entsprechende DNS-spezifische Fehlercode wie in Winerror.h definiert ist.

QueryOptions

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

pQueryRecords

Ein Zeiger auf eine DNS_RECORD Struktur.

Wenn die Abfrage asynchron abgeschlossen wurde und diese Struktur direkt von DnsQueryEx-zurückgegeben wurde, ist pQueryRecords NULL.

Wenn die Abfrage synchron abgeschlossen wurde oder diese Struktur vom DNS_QUERY_COMPLETION_ROUTINE DNS-Rückruf zurückgegeben wurde, enthält pQueryRecords eine Liste der Ressourceneinträge (Resource Records, RR), die die Antwort umfassen.

Note Applications must free returned RR sets with the DnsRecordListFree function.

Reserved

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

DNS_QUERY_REQUEST

Freigeben über