fungsi DnsExtractRecordsFromMessage_UTF8 (windns.h)

Artikel
03/04/2024

Jenis fungsi DnsExtractRecordsFromMessage mengekstrak rekaman sumber daya (RR) dari pesan DNS, dan menyimpan rekaman tersebut dalam struktur DNS_RECORD . Seperti banyak fungsi DNS, jenis fungsi DnsExtractRecordsFromMessage diimplementasikan dalam beberapa bentuk untuk memfasilitasi pengodean karakter yang berbeda. Berdasarkan pengodean karakter yang terlibat, gunakan salah satu fungsi berikut:

DnsExtractRecordsFromMessage_W (_W untuk pengodean Unicode)
DnsExtractRecordsFromMessage_UTF8 (_UTF8 untuk pengodean UTF-8)

Jika jenis fungsi DnsExtractRecordsFromMessage digunakan tanpa akhirannya (baik _W atau _UTF8), kesalahan pengompilasi akan terjadi.

Sintaks

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

Parameter

[in] pDnsBuffer

Penunjuk ke struktur DNS_MESSAGE_BUFFER yang berisi pesan respons DNS.

[in] wMessageLength

Ukuran, dalam byte, pesan dalam pDnsBuffer.

[out] ppRecord

Penunjuk ke struktur DNS_RECORD yang berisi daftar RR yang diekstrak. Untuk membebaskan catatan ini, gunakan fungsi DnsRecordListFree .

Nilai kembali

Mengembalikan konfirmasi keberhasilan setelah berhasil diselesaikan. Jika tidak, mengembalikan kode kesalahan khusus DNS yang sesuai seperti yang didefinisikan dalam Winerror.h.

Keterangan

Fungsi DnsExtractRecordsFromMessage dirancang untuk beroperasi pada pesan dalam urutan byte host. Dengan demikian, pesan yang diterima harus dikonversi dari urutan byte jaringan ke urutan byte host sebelum ekstraksi, atau sebelum transmisi ulang ke jaringan. Gunakan makro DNS_BYTE_FLIP_HEADER_COUNTS untuk mengubah urutan byte.

Deklarasi berikut untuk DnsExtractRecordsFromMessage_UTF8 dapat ditemukan di Windns.h.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	windns.h
Pustaka	Dnsapi.lib
DLL	Dnsapi.dll

Lihat juga

DnsWriteQuestionToBuffer

Bagikan melalui