DnsCancelQuery, fonction (windns.h)
La fonction DnsCancelQuery peut être utilisée pour annuler une requête en attente dans l’espace de noms DNS.
Syntaxe
DNS_STATUS DnsCancelQuery(
[in] PDNS_QUERY_CANCEL pCancelHandle
);
Paramètres
[in] pCancelHandle
Pointeur vers une structure de DNS_QUERY_CANCEL utilisée pour annuler une requête DNS asynchrone. La structure doit avoir été retournée dans le paramètre pCancelHandle d’un appel précédent à DnsQueryEx.
Valeur retournée
Retourne la confirmation de réussite en cas de réussite. Sinon, il retourne le code d’erreur dns approprié tel que défini dans Winerror.h.
Remarques
DnsCancelQuery n’attend pas la fin d’une requête avant l’annulation. Par conséquent, les applications doivent suivre les requêtes en attente via leurs rappels DNS DNS_QUERY_COMPLETION_ROUTINE .
pCancelHandle est valide jusqu’à ce que le rappel DNS DNS_QUERY_COMPLETION_ROUTINE soit appelé et que DnsCancelQuery se termine.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | windns.h |
| Bibliothèque | Dnsapi.lib |
| DLL | Dnsapi.dll |