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

Consulte también

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST

DNS_QUERY_RESULT

DnsQuery

DnsQueryEx