Compartilhar via


DNS_QUERY_RAW_COMPLETION_ROUTINE função de retorno de chamada (windns.h)

Importante

Algumas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

DNS_QUERY_RAW_COMPLETION_ROUTINE é a assinatura de função de uma função de retorno de chamada assíncrona que você implementa. O sistema chama sua implementação com os resultados de uma consulta que você iniciou chamando DnsQueryRaw. Os resultados contêm os registros analisados e o pacote de resultados brutos, a serem passados para sistemas posteriores conforme desejado. O resultado fornece informações sobre o servidor que forneceu os resultados.

O sistema chamará esse retorno de chamada na conclusão da consulta se DnsQueryRaw retornar DNS_REQUEST_PENDING; e indicará os resultados da consulta se tiver êxito ou quaisquer falhas ou cancelamentos.

Sintaxe

DNS_QUERY_RAW_COMPLETION_ROUTINE DnsQueryRawCompletionRoutine;

void DnsQueryRawCompletionRoutine(
  VOID *queryContext,
  DNS_QUERY_RAW_RESULT *queryResults
)
{...}

Parâmetros

queryContext

Tipo: _In_ VOID*

Um ponteiro para o contexto de consulta que foi passado para DnsQueryRaw por meio do campo queryContext de DNS_QUERY_RAW_REQUEST.

queryResults

Tipo: _Inout_ DNS_QUERY_RAW_RESULT*

Um ponteiro para os resultados da consulta. Se esse retorno de chamada for feito devido a um cancelamento de consulta por meio de DnsCancelQueryRaw, o campo queryStatus em queryResults será definido como ERROR_CANCELLED.

Se não NULLfor , você deverá liberar o ponteiro queryResults usando DnsQueryRawResultFree.

Retornar valor

Nenhum

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho windns.h