DNS_QUERY_RAW_COMPLETION_ROUTINE Rückruffunktion (windns.h)

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe wesentlich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

DNS_QUERY_RAW_COMPLETION_ROUTINE ist die Funktionssignatur einer asynchronen Rückruffunktion, die Sie implementieren. Das System ruft Ihre Implementierung mit den Ergebnissen einer Abfrage auf, die Sie durch Aufrufen von DnsQueryRaw initiiert haben. Die Ergebnisse enthalten sowohl die analysierten Datensätze als auch das Unformatierte Ergebnispaket, das wie gewünscht an spätere Systeme übergeben werden soll. Das Ergebnis enthält Informationen zu dem Server, der die Ergebnisse bereitgestellt hat.

Das System ruft diesen Rückruf bei Abschluss der Abfrage auf, wenn DnsQueryRawDNS_REQUEST_PENDING zurückgibt. und gibt die Ergebnisse der Abfrage an, wenn erfolgreich oder fehler oder abbrüche.

Syntax

DNS_QUERY_RAW_COMPLETION_ROUTINE DnsQueryRawCompletionRoutine;

void DnsQueryRawCompletionRoutine(
  VOID *queryContext,
  DNS_QUERY_RAW_RESULT *queryResults
)
{...}

Parameter

queryContext

Typ: _In_ VOID*

Ein Zeiger auf den Abfragekontext, der über das QueryContext-Feld von DNS_QUERY_RAW_REQUEST an DnsQueryRaw übergeben wurde.

queryResults

Typ: _Inout_ DNS_QUERY_RAW_RESULT*

Ein Zeiger auf die Ergebnisse der Abfrage. Wenn dieser Rückruf aufgrund eines Abfrageabbruchs über DnsCancelQueryRaw erfolgt, wird das Feld queryStatus in queryResults auf ERROR_CANCELLED festgelegt.

Wenn dies nicht NULLder Fall ist, müssen Sie den queryResults-Zeiger mithilfe von DnsQueryRawResultFree freigeben.

Rückgabewert

Keine

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	windns.h