Fungsi DsReplicaSyncA (ntdsapi.h)

Fungsi DsReplicaSync menyinkronkan konteks penamaan tujuan (NC) dengan salah satu sumbernya.

Sintaksis

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [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 dari NC tujuan.

[in] pUuidDsaSrc

Penunjuk ke UUID sumber yang mereplikasi ke NC tujuan.

[in] Options

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

DS_REPSYNC_ADD_REFERENCE

Menyebabkan agen sistem direktori sumber (DSA) memverifikasi bahwa DSA lokal ada dalam daftar replikasi sumber ke. Jika tidak, DSA lokal ditambahkan. Ini memastikan bahwa sumber mengirim pemberitahuan perubahan.

DS_REPSYNC_ALL_SOURCES

Nilai ini tidak didukung.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista dan Windows Server 2003: Menyinkronkan dari semua sumber.

DS_REPSYNC_ASYNCHRONOUS_OPERATION

Melakukan operasi ini secara asinkron.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista dan Windows Server 2003: Diperlukan saat menggunakan DS_REPSYNC_ALL_SOURCES.

DS_REPSYNC_FORCE

Menyinkronkan meskipun tautan saat ini dinonaktifkan.

DS_REPSYNC_FULL

Menyinkronkan mulai dari Update Sequence Number (USN) pertama.

DS_REPSYNC_INTERSITE_MESSAGING

Menyinkronkan menggunakan ISM.

DS_REPSYNC_NO_DISCARD

Tidak membuang permintaan sinkronisasi ini, meskipun sinkronisasi serupa tertunda.

DS_REPSYNC_PERIODIC

Menunjukkan operasi ini adalah permintaan sinkronisasi berkala seperti yang dijadwalkan oleh administrator.

DS_REPSYNC_URGENT

Menunjukkan operasi ini adalah pemberitahuan pembaruan yang ditandai mendesak.

DS_REPSYNC_WRITEABLE

Replika dapat ditulis. Jika tidak, itu baca-saja.

Mengembalikan nilai

Jika fungsi berhasil melakukan operasinya, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai pengembalian adalah salah satu kesalahan API Win32 standar.

Komentar

Server yang DsReplicaSync dijalankan disebut tujuan. Konteks penamaan tujuan dibawa up-to-date sehubungan dengan sistem sumber, yang diidentifikasi oleh UUID dari objek Pengaturan NTDS sistem sumber. Sistem tujuan harus sudah dikonfigurasi sehingga sistem sumber adalah salah satu sistem tempat sistem menerima data replikasi.

Catatan Memaksa sinkronisasi manual dapat mencegah layanan direktori memprioritaskan operasi replikasi dengan benar. Misalnya, menyinkronkan pengguna baru dapat mendahului sinkronisasi mendesak yang dilakukan untuk menyediakan akses ke pengguna yang baru saja dikunci atau untuk menambahkan kata sandi kepercayaan baru. Jika Anda sering memanggil API ini, Anda dapat membanjiri jaringan dengan permintaan, yang dapat mengganggu operasi replikasi lainnya. Untuk alasan ini, sangat disarankan agar fungsi ini hanya digunakan untuk skenario sekali pakai daripada memasukkannya ke dalam aplikasi yang akan menggunakannya secara teratur.

 

Nota

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

DsReplicaModify

DsReplicaUpdateRefs