Fungsi DsReplicaUpdateRefsA (ntdsapi.h)

Fungsi DsReplicaUpdateRefs menambahkan atau menghapus referensi replikasi untuk tujuan dari konteks penamaan sumber.

Sintaksis

NTDSAPI DWORD DsReplicaUpdateRefsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] LPCSTR     DsaDest,
  [in] const UUID *pUuidDsaDest,
  [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 konstan yang menentukan nama khusus konteks penamaan sumber.

[in] DsaDest

Penunjuk ke string yang dihentikan null konstanta yang menentukan alamat khusus transportasi agen sistem direktori tujuan.

[in] pUuidDsaDest

Penunjuk ke nilai UUID yang berisi agen sistem direktori tujuan.

[in] Options

Berisi sekumpulan bendera yang menyediakan data tambahan yang digunakan untuk memproses permintaan. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

DS_REPUPD_ADD_REFERENCE

Referensi ke tujuan ditambahkan ke server sumber.

DS_REPUPD_ASYNCHRONOUS_OPERATION

Operasi dilakukan secara asinkron.

DS_REPUPD_DELETE_REFERENCE

Referensi ke tujuan dihapus dari server sumber.

DS_REPUPD_WRITEABLE

Referensi ke replika yang ditambahkan atau dihapus dapat ditulis. Jika tidak, itu baca-saja.

Mengembalikan nilai

Jika fungsi berhasil, ERROR_SUCCESS dikembalikan.

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

Komentar

Jika DS_REPUPD_ADD_REFERENCE dan DS_REPUPD_DELETE_REFERENCE diatur dalam parameter Opsi , referensi ke tujuan ditambahkan jika belum ada di server. Jika referensi ke tujuan sudah ada, referensi akan diperbarui.

Nota

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

DsReplicaSync