DnsCancelQuery-Funktion (windns.h)

Die DnsCancelQuery-Funktion kann verwendet werden, um eine ausstehende Abfrage an den DNS-Namespace abzubrechen.

Syntax

DNS_STATUS DnsCancelQuery(
  [in] PDNS_QUERY_CANCEL pCancelHandle
);

Parameter

[in] pCancelHandle

Ein Zeiger auf eine DNS_QUERY_CANCEL Struktur, die zum Abbrechen einer asynchronen DNS-Abfrage verwendet wird. Die Struktur muss im pCancelHandle-Parameter eines vorherigen Aufrufs von DnsQueryEx zurückgegeben worden sein.

Rückgabewert

Gibt nach erfolgreichem Abschluss eine Erfolgsbestätigung zurück. Andernfalls wird der entsprechende DNS-spezifische Fehlercode zurückgegeben, der in Winerror.h definiert ist.

Hinweise

DnsCancelQuery wartet nicht, bis eine Abfrage abgeschlossen ist, bevor sie abgebrochen wird. Daher sollten Anwendungen ausstehende Abfragen über ihre DNS_QUERY_COMPLETION_ROUTINE DNS-Rückrufe nachverfolgen.

pCancelHandle ist gültig, bis der DNS_QUERY_COMPLETION_ROUTINE DNS-Rückruf aufgerufen und DnsCancelQuery abgeschlossen ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile windns.h
Bibliothek Dnsapi.lib
DLL Dnsapi.dll

Weitere Informationen

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST

DNS_QUERY_RESULT

DnsQuery

DnsQueryEx