Função DnsCancelQuery (windns.h)
A função DnsCancelQuery pode ser usada para cancelar uma consulta pendente para o namespace DNS.
Sintaxe
DNS_STATUS DnsCancelQuery(
[in] PDNS_QUERY_CANCEL pCancelHandle
);
Parâmetros
[in] pCancelHandle
Um ponteiro para uma estrutura DNS_QUERY_CANCEL usada para cancelar uma consulta DNS assíncrona. A estrutura deve ter sido retornada no parâmetro pCancelHandle de uma chamada anterior para DnsQueryEx.
Retornar valor
Retorna a confirmação de êxito após a conclusão bem-sucedida. Caso contrário, ele retornará o código de erro específico do DNS apropriado, conforme definido em Winerror.h.
Comentários
O DnsCancelQuery não aguarda a conclusão de uma consulta antes do cancelamento. Portanto, os aplicativos devem acompanhar consultas pendentes por meio de seus DNS_QUERY_COMPLETION_ROUTINE retornos de chamada DNS.
pCancelHandle é válido até que o DNS_QUERY_COMPLETION_ROUTINE retorno de chamada DNS seja invocado e DnsCancelQuery seja concluído.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | windns.h |
| Biblioteca | Dnsapi.lib |
| DLL | Dnsapi.dll |