fungsi DnsModifyRecordsInSet_A (windns.h)

Artikel
08/27/2023

Fungsi DnsModifyRecordsInSet menambahkan, memodifikasi, atau menghapus kumpulan Catatan Sumber Daya (RR) yang mungkin sebelumnya telah terdaftar di server DNS.

Seperti banyak fungsi DNS, jenis fungsi DnsModifyRecordsInSet diimplementasikan dalam beberapa formulir untuk memfasilitasi pengodean karakter yang berbeda. Berdasarkan pengodean karakter yang terlibat, gunakan salah satu fungsi berikut:

DnsModifyRecordsInSet_A (_A untuk pengodean ANSI)
DnsModifyRecordsInSet_W (_W untuk pengodean Unicode)
DnsModifyRecordsInSet_UTF8 (_UTF8 untuk pengodean UTF 8)

Sintaks

DNS_STATUS DnsModifyRecordsInSet_A(
  [in, optional]      PDNS_RECORD pAddRecords,
  [in, optional]      PDNS_RECORD pDeleteRecords,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hCredentials,
  [in, out, optional] PVOID       pExtraList,
  [in, out, optional] PVOID       pReserved
);

Parameter

[in, optional] pAddRecords

Penunjuk ke struktur DNS_RECORD yang berisi RR yang akan ditambahkan ke set RR.

[in, optional] pDeleteRecords

Penunjuk ke struktur DNS_RECORD yang berisi RR yang akan dihapus dari rangkaian RR.

[in] Options

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

[in, optional] hCredentials

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

[in, out, optional] pExtraList

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, kode kesalahan khusus DNS yang sesuai akan ditampilkan seperti yang didefinisikan dalam Winerror.h.

Keterangan

Jenis fungsi DnsModifyRecordsInSet dijalankan dalam langkah-langkah berikut.

Rekaman yang ditentukan dalam pDeleteRecords dihapus. Jika pDeleteRecords kosong atau tidak berisi rekaman yang ada di set saat ini, fungsi DnsModifyRecordsInSet masuk ke langkah berikutnya.
Rekaman yang ditentukan dalam pAddRecords ditambahkan. Jika pAddRecords kosong, operasi selesai tanpa menambahkan rekaman apa pun.

Untuk menambahkan rekaman baru, jangan berikan rekaman di pDeleteRecords, dan berikan catatan yang akan ditambahkan di pAddRecords. Untuk mengubah rekaman, tentukan rekaman yang sedang dimodifikasi di pDeleteRecords, lalu tambahkan versi rekaman yang dimodifikasi dengan menempatkannya di pAddRecords. Untuk menghapus rekaman, tentukan hanya rekaman yang akan dihapus. Beberapa rekaman dapat ditambahkan atau dihapus dalam satu panggilan ke DnsModifyRecordsInSet; namun, nilai anggota pName di setiap DNS_RECORD harus sama atau panggilan akan gagal. Jika rekaman yang ditentukan dalam pAddRecords sudah ada, tidak ada perubahan yang terjadi.

Jika tidak ada daftar server yang ditentukan, server nama default akan dikueri.

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

DnsQuery

DnsReplaceRecordSet

Bagikan melalui