DnsExtractRecordsFromMessage_W函式 (windns.h)

DnsExtractRecordsFromMessage函式類型會從 DNS 訊息擷取 (RR) 的資源記錄，並將這些記錄儲存在DNS_RECORD結構中。 就像許多 DNS 函式一樣， DnsExtractRecordsFromMessage 函式類型是以多個形式實作，以利不同的字元編碼。 根據所涉及的字元編碼，使用下列其中一個函式：

• unicode 編碼) 的 DnsExtractRecordsFromMessage_W (_W
• 適用于 UTF-8 編碼) 的DnsExtractRecordsFromMessage_UTF8 (_UTF8

語法

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

參數

[in] pDnsBuffer

包含 DNS 回應訊息 之DNS_MESSAGE_BUFFER 結構的指標。

[in] wMessageLength

pDnsBuffer中訊息的大小，以位元組為單位。

[out] ppRecord

包含所擷取之 RU 清單 之DNS_RECORD 結構的指標。 若要釋放這些記錄，請使用 DnsRecordListFree 函式。

傳回值

在成功完成時傳回成功確認。 否則，傳回 Winerror.h 中定義的適當 DNS 特定錯誤碼。

備註

DnsExtractRecordsFromMessage函式是設計來以主機位元組順序操作訊息。 因此，接收的訊息應該從網路位元組順序轉換成擷取前的主機位元組順序，或重新傳輸至網路之前。 使用DNS_BYTE_FLIP_HEADER_COUNTS宏來變更位元組順序。

您可以在 Windns.h 中找到 下列DnsExtractRecordsFromMessage_UTF8 宣告。

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

規格需求

另請參閱

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

DnsRecordListFree

DnsWriteQuestionToBuffer