Fungsi DnsCancelQuery (windns.h)
Fungsi DnsCancelQuery dapat digunakan untuk membatalkan kueri yang tertunda ke namespace DNS.
Sintaks
DNS_STATUS DnsCancelQuery(
[in] PDNS_QUERY_CANCEL pCancelHandle
);
Parameter
[in] pCancelHandle
Penunjuk ke struktur DNS_QUERY_CANCEL yang digunakan untuk membatalkan kueri DNS asinkron. Struktur harus dikembalikan dalam parameter pCancelHandle dari panggilan sebelumnya ke DnsQueryEx.
Nilai kembali
Mengembalikan konfirmasi keberhasilan setelah berhasil diselesaikan. Jika tidak, kode kesalahan khusus DNS yang sesuai akan ditampilkan seperti yang didefinisikan dalam Winerror.h.
Keterangan
DnsCancelQuery tidak menunggu kueri selesai sebelum membatalkan. Oleh karena itu, aplikasi harus melacak kueri yang tertunda melalui panggilan balik DNS DNS_QUERY_COMPLETION_ROUTINE mereka.
pCancelHandle valid hingga panggilan balik DNS DNS_QUERY_COMPLETION_ROUTINE dipanggil dan DnsCancelQuery selesai.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | windns.h |
| Pustaka | Dnsapi.lib |
| DLL | Dnsapi.dll |