DnsWriteQuestionToBuffer_W (windns.h)

Artikel
03/15/2023

Jenis fungsi DnsWriteQuestionToBuffer membuat pesan kueri DNS dan menyimpannya dalam struktur DNS_MESSAGE_BUFFER . Seperti banyak fungsi DNS, jenis fungsi DnsWriteQuestionToBuffer diimplementasikan dalam beberapa bentuk untuk memfasilitasi pengodean karakter yang berbeda. Berdasarkan pengodean karakter yang terlibat, gunakan salah satu fungsi berikut:

DnsWriteQuestionToBuffer_W (_W untuk pengodean Unicode)
DnsWriteQuestionToBuffer_UTF8 (_UTF8 untuk pengodean UTF-8)

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

Sintaks

BOOL DnsWriteQuestionToBuffer_W(
  [in, out] PDNS_MESSAGE_BUFFER pDnsBuffer,
  [in, out] PDWORD              pdwBufferSize,
  [in]      PCWSTR              pszName,
  [in]      WORD                wType,
  [in]      WORD                Xid,
  [in]      BOOL                fRecursionDesired
);

Parameter

[in, out] pDnsBuffer

Penunjuk ke struktur DNS_MESSAGE_BUFFER yang berisi pesan kueri DNS yang disimpan dalam buffer.

[in, out] pdwBufferSize

Ukuran, dalam byte, dari buffer yang dialokasikan untuk menyimpan pDnsBuffer. Jika ukuran buffer tidak mencukupi untuk memuat pesan, FALSE dikembalikan dan pdwBufferSize berisi ukuran buffer minimum yang diperlukan.

[in] pszName

Penunjuk ke string yang mewakili nama pemilik kumpulan catatan yang sedang dikueri.

[in] wType

Nilai yang mewakili Tipe Catatan DNS RR. wType menentukan format Data. Misalnya, jika nilai wTypeDNS_TYPE_A, jenis data DataDNS_A_DATA.

[in] Xid

Nilai yang menentukan pengidentifikasi kueri DNS unik.

[in] fRecursionDesired

BOOL yang menentukan apakah kueri nama rekursif harus digunakan oleh server nama DNS. Atur ke TRUE untuk meminta kueri nama rekursif, FALSE untuk meminta kueri nama berulang.

Nilai kembali

Mengembalikan TRUE setelah eksekusi berhasil, jika tidak FALSE.

Keterangan

Deklarasi berikut untuk DnsWriteQuestionToBuffer_UTF8 dapat ditemukan di Windns.h.

BOOL
WINAPI
DnsWriteQuestionToBuffer_UTF8(
    __inout     PDNS_MESSAGE_BUFFER pDnsBuffer,
    __inout     PDWORD              pdwBufferSize,
    __in        PCSTR               pszName,
    __in        WORD                wType,
    __in        WORD                Xid,
    __in        BOOL                fRecursionDesired
    );

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

DNS_MESSAGE_BUFFER

DNS_RECORD

DnsQuery

Bagikan melalui