次の方法で共有

DnsExtractRecordsFromMessage_UTF8関数 (windns.h)

  • [アーティクル]

DnsExtractRecordsFromMessage 関数の種類は、DNS メッセージからリソース レコード (RR) を抽出し、それらのレコードを DNS_RECORD 構造体に格納します。 多くの DNS 関数と同様に、DnsExtractRecordsFromMessage 関数の種類は、異なる文字エンコードを容易にするために複数の形式で実装されます。 関連する文字エンコードに基づいて、次のいずれかの関数を使用します。

  • DnsExtractRecordsFromMessage_W (Unicode エンコードの_W)
  • DnsExtractRecordsFromMessage_UTF8 (UTF-8 エンコードの_UTF8)
DnsExtractRecordsFromMessage 関数型がサフィックス (_Wまたは_UTF8) なしで使用されている場合は、コンパイラ エラーが発生します。

構文

DNS_STATUS DnsExtractRecordsFromMessage_UTF8(
  [in]  PDNS_MESSAGE_BUFFER pDnsBuffer,
  [in]  WORD                wMessageLength,
  [out] PDNS_RECORD         *ppRecord
);

パラメーター

[in] pDnsBuffer

DNS 応答メッセージを含む DNS_MESSAGE_BUFFER 構造体へのポインター。

[in] wMessageLength

pDnsBuffer内のメッセージ サイズ (バイト単位)。

[out] ppRecord

抽出された RR の一覧を含む DNS_RECORD 構造体へのポインター。 これらのレコードを解放するには、DnsRecordListFree 関数を使用します。

戻り値

正常に完了すると、成功の確認を返します。 それ以外の場合は、Winerror.h で定義されている適切な DNS 固有のエラー コードを返します。

備考

DnsExtractRecordsFromMessage 関数は、ホストのバイト順でメッセージを操作するように設計されています。 そのため、受信したメッセージは、抽出前またはネットワークへの再送信の前に、ネットワークのバイトオーダーからホストのバイトオーダーに変換する必要があります。 DNS_BYTE_FLIP_HEADER_COUNTS マクロを使用してバイト順序を変更します。

次の DnsExtractRecordsFromMessage_UTF8 の宣言は Windns.h にあります。

DNS_STATUS
WINAPI
DnsExtractRecordsFromMessage_UTF8(
    __in            PDNS_MESSAGE_BUFFER pDnsBuffer,
    __in            WORD                wMessageLength,
    __deref_out     PDNS_RECORD *       ppRecord
    );

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー windns.h
ライブラリ Dnsapi.lib
DLL Dnsapi.dll

関連項目

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

DnsRecordListFree

DnsWriteQuestionToBuffer