Funzione DnsCancelQuery (windns.h)
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 |