Win32 API 日本語リファレンス
ホーム › NetworkManagement.Dns › DNS_QUERY_RAW_COMPLETION_ROUTINE

DNS_QUERY_RAW_COMPLETION_ROUTINE

コールバック

シグネチャ

void DNS_QUERY_RAW_COMPLETION_ROUTINE(
    void* queryContext,
    DNS_QUERY_RAW_RESULT* queryResults
);

パラメーター

フィールド型説明
queryContextvoid*DNS_QUERY_RAW_REQUEST の queryContext フィールドを通じて DnsQueryRaw に渡されたクエリコンテキストへのポインターです。
queryResultsDNS_QUERY_RAW_RESULT*

クエリ結果へのポインターです。DnsCancelQueryRaw によるクエリのキャンセルが原因でこのコールバックが呼び出された場合、queryResults の queryStatus フィールドには ERROR_CANCELLED が設定されます。

NULL でない場合は、DnsQueryRawResultFree を使用して queryResults ポインターを解放する必要があります。

公式ドキュメント

DNS_QUERY_RAW_COMPLETION_ROUTINE は、アプリケーションが実装する非同期コールバック関数の関数シグネチャです。システムは、DnsQueryRaw を呼び出して開始したクエリの結果を渡して、この実装を呼び出します。結果には解析済みのレコードと生の結果パケットの両方が含まれており、必要に応じて後続のシステムへ渡すことができます。また、結果を提供したサーバーに関する情報も得られます。

DnsQueryRaw が DNS_REQUEST_PENDING を返した場合、システムは、クエリの完了時にこのコールバックを呼び出します。クエリが成功した場合はその結果を、失敗またはキャンセルされた場合はその内容を通知します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)