Fungsi DnsReplaceRecordSetUTF8 (windns.h)

Artikel
08/27/2023

Jenis fungsi DnsReplaceRecordSet menggantikan kumpulan catatan sumber daya (RR) yang sudah ada. Seperti banyak fungsi DNS, jenis fungsi DnsReplaceRecordSet diimplementasikan dalam beberapa bentuk untuk memfasilitasi pengodean karakter yang berbeda, yang ditunjukkan oleh akhiran. Berdasarkan pengodean karakter yang terlibat, gunakan salah satu fungsi berikut:

DnsReplaceRecordSetA (_A untuk pengodean ANSI)

DnsReplaceRecordSetW (_W untuk pengodean Unicode)

DnsReplaceRecordSetUTF8 (_UTF8 untuk pengodean UTF 8)

Waspadai kurangnya garis bawah antara nama jenis fungsi dan akhirannya. Jika jenis fungsi DnsReplaceRecordSet dipanggil tanpa akhirannya (A, W, atau UTF8), kesalahan pengkompilasi akan terjadi.

Sintaks

DNS_STATUS DnsReplaceRecordSetUTF8(
  [in]                PDNS_RECORD pReplaceSet,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hContext,
  [in, out, optional] PVOID       pExtraInfo,
  [in, out, optional] PVOID       pReserved
);

Parameter

[in] pReplaceSet

Penunjuk ke struktur DNS_RECORD yang berisi set RR yang menggantikan set yang ada. RR yang ditentukan diganti dengan konten pNewSet. Untuk menghapus set RR, tentukan set di pNewSet, tetapi atur RDATA ke NULL.

[in] Options

Nilai yang berisi bitmap Opsi Pembaruan DNS. Opsi dapat digabungkan dan semua opsi mengambil alih DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hContext

Handel ke kredensial akun tertentu. Digunakan saat pembaruan dinamis aman diperlukan. Parameter ini bersifat opsional.

[in, out, optional] pExtraInfo

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

[in, out, optional] pReserved

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

Mengembalikan nilai

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

Persyaratan


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_RECORD

DnsModifyRecordsInSet

Bagikan melalui