DNS_QUERY_RAW_COMPLETION_ROUTINE回呼函式 (windns.h)

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_REQUEST 的 queryContext 字段傳遞至 DnsQueryRaw 的查詢內容指標。

queryResults

類型：_Inout_ DNS_QUERY_RAW_RESULT*

查詢結果的指標。 如果此回呼是因為透過 DnsCancelQueryRaw 取消查詢而建立，則 queryResults 中的 queryStatus 字段會設定為 ERROR_CANCELLED。

如果不是 NULL，則必須使用 DnsQueryRawResultFree 釋放 queryResults 指標。

傳回值

無

規格需求