Fungsi DsReplicaDelW (ntdsapi.h)

Artikel
11/20/2024

Fungsi DsReplicaDel menghapus referensi sumber replikasi dari konteks penamaan tujuan (NC).

Sintaksis

NTDSAPI DWORD DsReplicaDelW(
  [in] HANDLE  hDS,
  [in] LPCWSTR NameContext,
  [in] LPCWSTR DsaSrc,
  [in] ULONG   Options
);

Parameter

[in] hDS

Berisi handel layanan direktori yang diperoleh dari DSBind atau fungsi DSBindWithCred.

[in] NameContext

Penunjuk ke string yang dihentikan null konstanta yang menentukan nama khusus (DN) dari NC tujuan untuk menghapus replika. Rekaman NC tujuan harus ada secara lokal sebagai objek, dibuat atau tidak, atau phantom referensi, misalnya, phantom dengan GUID.

[in] DsaSrc

Penunjuk ke string Unicode yang dihentikan null konstan yang menentukan alamat khusus transportasi agen sistem direktori sumber (DSA). Server sumber ini diidentifikasi dengan nama string, bukan olehUUID . Nama string yang sesuai untuk DsaSrc biasanya adalah nama DNS yang didasarkan padaGUID , di mana GUID bagian dari nama adalah GUID objek nTDSDSA untuk server sumber.

[in] Options

Meneruskan data tambahan yang digunakan untuk memproses permintaan. Parameter ini bisa menjadi kombinasi dari nilai berikut.

DS_REPDEL_ASYNCHRONOUS_OPERATION

Melakukan operasi ini secara asinkron.

DS_REPDEL_IGNORE_ERRORS

Mengabaikan kesalahan apa pun yang dihasilkan dari menghubungi sumber untuk menginstruksikannya untuk menghapus NC ini dari daftar server yang direplikasinya.

DS_REPDEL_INTERSITE_MESSAGING

Menandakan replika berbasis email daripada disinkronkan menggunakan RPC layanan direktori asli.

DS_REPDEL_LOCAL_ONLY

Tidak menghubungi sumber untuk memberi tahunya untuk menghapus NC ini dari daftar server yang direplikasinya. Jika bendera ini tidak diatur dan tautan didasarkan pada RPC, sumber akan dihubungi.

DS_REPDEL_NO_SOURCE

Menghapus semua objek di NC. Opsi ini hanya valid untuk NC baca-saja tanpa sumber.

DS_REPDEL_REF_OK

Memungkinkan penghapusan replika baca-saja meskipun sumber replika baca-saja lainnya.

DS_REPDEL_WRITEABLE

Menandakan bahwa replika yang dihapus dapat ditulis.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian ERROR_SUCCESS.

Jika fungsi gagal, nilai pengembalian adalah kesalahan API Win32 standar atau ERROR_INVALID_PARAMETER jika parameter tidak valid.

Komentar

Nota

Header ntdsapi.h mendefinisikan DsReplicaDel sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	ntdsapi.h
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll