Fungsi DnsReplaceRecordSetW (windns.h)

Artikel
03/04/2024

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 DnsReplaceRecordSetW(
  [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.

Keterangan

Catatan

Header windns.h mendefinisikan DnsReplaceRecordSet sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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_RECORD

DnsModifyRecordsInSet

Bagikan melalui