DNS_QUERY_RAW_COMPLETION_ROUTINE回调函数 (windns.h)

重要

某些信息与预发行产品相关,在商业发布之前,该产品可能会进行实质性修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。

DNS_QUERY_RAW_COMPLETION_ROUTINE 是实现的异步回调函数的函数签名。 系统使用通过调用 DnsQueryRaw 启动的查询结果调用实现。 结果同时包含分析的记录和原始结果数据包,将根据需要传递给更高版本的系统。 结果提供有关提供结果的服务器的信息。

如果 DnsQueryRaw 返回 DNS_REQUEST_PENDING,则系统会在查询完成时调用此回调;如果成功,它将指示查询的结果,或者任何失败或取消。

语法

DNS_QUERY_RAW_COMPLETION_ROUTINE DnsQueryRawCompletionRoutine;

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

参数

queryContext

类型:_In_ VOID*

指向通过 DNS_QUERY_RAW_REQUESTqueryContext 字段传递到 DnsQueryRaw 的查询上下文的指针。

queryResults

类型:_Inout_ DNS_QUERY_RAW_RESULT*

指向查询结果的指针。 如果此回调是由于通过 DnsCancelQueryRaw 取消查询而进行的,则 queryResults 中的 queryStatus 字段将设置为 ERROR_CANCELLED

如果不是 NULL,则必须使用 DnsQueryRawResultFree 释放 queryResults 指针。

返回值

要求

要求
目标平台 Windows
标头 windns.h