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 |