Función DnsCancelQuery (windns.h)
La función DnsCancelQuery se puede usar para cancelar una consulta pendiente en el espacio de nombres DNS.
Sintaxis
DNS_STATUS DnsCancelQuery(
[in] PDNS_QUERY_CANCEL pCancelHandle
);
Parámetros
[in] pCancelHandle
Puntero a una estructura de DNS_QUERY_CANCEL utilizada para cancelar una consulta DNS asincrónica. La estructura debe haberse devuelto en el parámetro pCancelHandle de una llamada anterior a DnsQueryEx.
Valor devuelto
Devuelve la confirmación correcta tras la finalización correcta. De lo contrario, devuelve el código de error específico de DNS adecuado, tal como se define en Winerror.h.
Comentarios
DnsCancelQuery no espera a que se complete una consulta antes de cancelarse. Por lo tanto, las aplicaciones deben realizar un seguimiento de las consultas pendientes a través de sus devoluciones de llamada dns DNS_QUERY_COMPLETION_ROUTINE .
pCancelHandle es válido hasta que se invoca la devolución de llamada DNS de DNS_QUERY_COMPLETION_ROUTINE y se completa DnsCancelQuery .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | windns.h |
| Library | Dnsapi.lib |
| Archivo DLL | Dnsapi.dll |