DnsCancelQuery-Funktion (windns.h)

Artikel
08/27/2023

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