Funzione DnsCancelQuery (windns.h)

Articolo
08/27/2023

La funzione DnsCancelQuery può essere usata per annullare una query in sospeso nello spazio dei nomi DNS.

Sintassi

DNS_STATUS DnsCancelQuery(
  [in] PDNS_QUERY_CANCEL pCancelHandle
);

Parametri

[in] pCancelHandle

Puntatore a una struttura DNS_QUERY_CANCEL utilizzata per annullare una query DNS asincrona. La struttura deve essere stata restituita nel parametro pCancelHandle di una chiamata precedente a DnsQueryEx.

Valore restituito

Restituisce la conferma dell'esito positivo al completamento. In caso contrario, restituisce il codice di errore specifico del DNS appropriato, come definito in Winerror.h.

Commenti

DnsCancelQuery non attende il completamento di una query prima dell'annullamento. Di conseguenza, le applicazioni devono tenere traccia delle query in sospeso tramite i callback DNS DNS_QUERY_COMPLETION_ROUTINE .

pCancelHandle è valido fino a quando non viene richiamato il callback DNS DNS_QUERY_COMPLETION_ROUTINE e DnsCancelQuery viene completato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	Dnsapi.lib
DLL	Dnsapi.dll