DNS_QUERY_RESULT Struktur (windns.h)

Eine DNS_QUERY_RESULT-Struktur enthält die DNS-Abfrageergebnisse, die von einem Aufruf von DnsQueryEx zurü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;

Member

Version

Die Strukturversion muss eine der folgenden Sein:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

Der status des Aufrufs von DnsQueryEx.

Wenn die Abfrage asynchron abgeschlossen wurde und diese Struktur direkt von DnsQueryEx zurückgegeben wurde, enthält QueryStatusDNS_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 bei erfolgreicher Ausführung oder den entsprechenden DNS-spezifischen Fehlercode, wie in Winerror.h definiert.

QueryOptions

Ein Wert, der eine Bitmap der 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 wenn diese Struktur vom DNS_QUERY_COMPLETION_ROUTINE DNS-Rückruf zurückgegeben wurde, enthält pQueryRecords eine Liste der Ressourcendatensätze (Resource Records, RR), die die Antwort umfassen.

Hinweis Anwendungen müssen zurückgegebene RR-Sätze mit der DnsRecordListFree-Funktion freigeben.

 

Reserved

Anforderungen

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

Weitere Informationen

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST