Функция DnsCancelQuery (windns.h)
Функцию DnsCancelQuery можно использовать для отмены ожидающего запроса к пространству имен DNS.
Синтаксис
DNS_STATUS DnsCancelQuery(
[in] PDNS_QUERY_CANCEL pCancelHandle
);
Параметры
[in] pCancelHandle
Указатель на структуру DNS_QUERY_CANCEL , используемую для отмены асинхронного запроса DNS. Структура должна быть возвращена в параметре pCancelHandle предыдущего вызова DnsQueryEx.
Возвращаемое значение
Возвращает подтверждение успешного выполнения после успешного завершения. В противном случае возвращается соответствующий код ошибки dns, как определено в Winerror.h.
Комментарии
DnsCancelQuery не ожидает завершения запроса перед отменой. Поэтому приложения должны отслеживать ожидающие запросы с помощью обратных вызовов DNS DNS_QUERY_COMPLETION_ROUTINE .
pCancelHandle действителен до тех пор, пока не будет вызван обратный вызов DNS DNS_QUERY_COMPLETION_ROUTINE и dnsCancelQuery не завершится.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | windns.h |
| Библиотека | Dnsapi.lib |
| DLL | Dnsapi.dll |