Fungsi DsReplicaModifyW (ntdsapi.h)

Fungsi DsReplicaModify memodifikasi referensi sumber replikasi yang ada untuk konteks penamaan tujuan.

Sintaksis

NTDSAPI DWORD DsReplicaModifyW(
  [in] HANDLE          hDS,
  [in] LPCWSTR         NameContext,
  [in] const UUID      *pUuidSourceDsa,
  [in] LPCWSTR         TransportDn,
  [in] LPCWSTR         SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           ReplicaFlags,
  [in] DWORD           ModifyFields,
  [in] DWORD           Options
);

Parameter

[in] hDS

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

[in] NameContext

Penunjuk ke string yang dihentikan null konstan yang menentukan nama khusus (DN) dari konteks penamaan tujuan (NC).

[in] pUuidSourceDsa

Penunjuk ke UUID agen sistem direktori sumber (DSA). Parameter ini mungkin null jika ModifyFields tidak menyertakan DS_REPMOD_UPDATE_ADDRESS dan SourceDsaAddress tidak NULL.

[in] TransportDn

Dicadangkan untuk digunakan di masa mendatang. Nilai apa pun selain NULL menghasilkan ERROR_NOT_SUPPORTED dikembalikan.

[in] SourceDsaAddress

Penunjuk ke string Unicode yang dihentikan null konstan yang menentukan alamat khusus transportasi dari DSA sumber. Parameter ini diabaikan jika pUuidSourceDsa tidak NULL dan ModifyFields tidak menyertakan DS_REPMOD_UPDATE_ADDRESS.

[in] pSchedule

Pointer ke struktur SCHEDULE yang berisi data jadwal replikasi untuk sumber replikasi. Parameter ini bersifat opsional dan dapat NULL jika tidak digunakan. Parameter ini diperlukan jika ModifyFields berisi bendera DS_REPMOD_UPDATE_SCHEDULE.

[in] ReplicaFlags

Parameter ini digunakan untuk mengontrol perilaku replikasi dan dapat mengambil nilai berikut.

DS_REPL_NBR_SYNC_ON_STARTUP

Replikasi konteks penamaan ini dari sumber ini dicoba ketika server tujuan di-boot. Ini biasanya hanya berlaku untuk tetangga intra-situs.

DS_REPL_NBR_DO_SCHEDULED_SYNCS

Lakukan replikasi sesuai jadwal. Bendera ini biasanya diatur kecuali jadwal untuk konteks penamaan dan sumber ini "tidak pernah", yaitu, jadwal kosong.

DS_REPL_NBR_TWO_WAY_SYNC

Jika diatur, menunjukkan bahwa ketika replikasi masuk selesai, server tujuan harus memberi tahu server sumber untuk menyinkronkan ke arah terbalik. Fitur ini digunakan dalam skenario dial-up di mana hanya salah satu dari dua server yang dapat memulai koneksi dial-up. Misalnya, opsi ini akan digunakan di kantor pusat perusahaan dan kantor cabang, di mana kantor cabang terhubung ke kantor pusat perusahaan melalui Internet melalui koneksi ISP dial-up.

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS

Tetangga ini diatur untuk menonaktifkan sinkronisasi berbasis pemberitahuan. Dalam situs, pengendali domain disinkronkan satu sama lain berdasarkan pemberitahuan ketika perubahan terjadi. Pengaturan ini mencegah tetangga ini melakukan sinkronisasi yang dipicu oleh pemberitahuan. Tetangga masih akan melakukan sinkronisasi berdasarkan jadwalnya atau sebagai respons terhadap sinkronisasi yang diminta secara manual.

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC

Tetangga ini diatur untuk tidak melakukan sinkronisasi berdasarkan jadwalnya. Satu-satunya cara tetangga ini akan melakukan sinkronisasi adalah sebagai respons terhadap perubahan pemberitahuan atau untuk sinkronisasi yang diminta secara manual.

DS_REPL_NBR_COMPRESS_CHANGES

Perubahan yang diterima dari sumber ini akan dikompresi. Ini biasanya diatur jika, dan hanya jika, server sumber berada di situs yang berbeda.

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

Tidak ada pemberitahuan perubahan yang harus diterima dari sumber ini. Ini biasanya diatur jika, dan hanya jika, server sumber berada di situs yang berbeda.

[in] ModifyFields

Menentukan bidang apa yang harus dimodifikasi. Setidaknya satu bidang harus ditentukan dalam ModifyFields . Parameter ini bisa menjadi kombinasi dari nilai berikut.

DS_REPMOD_UPDATE_ADDRESS

Memperbarui alamat yang terkait dengan server yang dirujuk.

DS_REPMOD_UPDATE_FLAGS

Memperbarui bendera yang terkait dengan replika.

DS_REPMOD_UPDATE_RESULT

Tidak digunakan. Menentukan pembaruan nilai hasil saat ini tidak didukung. Nilai hasil default ke 0.

DS_REPMOD_UPDATE_SCHEDULE

Memperbarui jadwal replikasi berkala yang terkait dengan replika.

DS_REPMOD_UPDATE_TRANSPORT

Memperbarui transportasi yang terkait dengan replika.

[in] Options

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

DS_REPMOD_ASYNCHRONOUS_OPERATION

Melakukan operasi ini secara asinkron.

DS_REPMOD_WRITEABLE

Menunjukkan bahwa replika yang dimodifikasi dapat ditulis.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian ERROR_SUCCESS.

Jika fungsi gagal, nilai pengembalian bisa menjadi salah satu dari yang berikut ini.

Komentar

Nota

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

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi

DsReplicaAdd

DsReplicaDel

DsReplicaSync

DsReplicaUpdateRefs

JADWAL