Fungsi DsReplicaAddA (ntdsapi.h)

Fungsi DsReplicaAdd menambahkan referensi sumber replikasi ke konteks penamaan tujuan.

Sintaksis

NTDSAPI DWORD DsReplicaAddA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] LPCSTR          SourceDsaDn,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           Options
);

Parameter

[in] hDS

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

[in] NameContext

String yang dihentikan null yang menentukan nama khusus (DN) dari konteks penamaan tujuan (NC) untuk menambahkan replika. Rekaman NC tujuan harus ada secara lokal sebagai objek, dibuat atau tidak, atau phantom referensi, misalnya, phantom dengan GUID.

[in] SourceDsaDn

String yang dihentikan null yang menentukan DN objek NTDS-DSA untuk agen sistem direktori sumber. Parameter ini diperlukan jika Opsi mencakup DS_REPADD_ASYNCHRONOUS_REPLICA; jika tidak, itu diabaikan.

[in] TransportDn

String null-terminated yang menentukan DN objek interSiteTransport yang mewakili transportasi yang digunakan untuk komunikasi dengan server sumber. Parameter ini diperlukan jika Opsi mencakup DS_REPADD_INTERSITE_MESSAGING; jika tidak, itu diabaikan.

[in] SourceDsaAddress

String yang dihentikan null yang menentukan alamat khusus transportasi dari DSA sumber. Server sumber ini diidentifikasi dengan nama string, bukan oleh UUID-nya. Nama string yang sesuai untuk SourceDsaAddress biasanya merupakan nama DNS berdasarkan GUID, di mana bagian GUID dari nama adalah GUID objek NTDS-DSA untuk server sumber.

[in] pSchedule

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

[in] Options

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

DS_REPADD_ASYNCHRONOUS_OPERATION

Melakukan operasi ini secara asinkron.

DS_REPADD_ASYNCHRONOUS_REPLICA

Tidak mereplikasi NC. Sebagai gantinya, simpan data status yang cukup sehingga dapat direplikasi nanti.

DS_REPADD_DISABLE_NOTIFICATION

Menonaktifkan sinkronisasi berbasis pemberitahuan untuk NC dari sumber ini. Ini diharapkan menjadi status sementara. Gunakan DS_REPADD_NEVER_NOTIFY untuk menonaktifkan sinkronisasi secara permanen.

DS_REPADD_DISABLE_PERIODIC

Menonaktifkan sinkronisasi berkala untuk NC dari sumber ini.

DS_REPADD_INITIAL

Menyinkronkan NC dari sumber ini ketika DSA dimulai.

DS_REPADD_INTERSITE_MESSAGING

Menyinkronkan dari DSA sumber menggunakan transportasi Intersite Messaging Service (IMS), misalnya, oleh SMTP, daripada menggunakan RPC layanan direktori asli.

DS_REPADD_NEVER_NOTIFY

Menonaktifkan pemberitahuan perubahan dari sumber ini. Ketika bendera ini diatur, sumber tidak memberi tahu tujuan ketika perubahan terjadi. Ini direkomendasikan untuk semua replikasi antarsitus yang mungkin terjadi melalui tautan WAN.

Ini diharapkan menjadi status permanen; gunakan DS_REPADD_DISABLE_NOTIFICATION untuk menonaktifkan pemberitahuan untuk sementara.

DS_REPADD_PERIODIC

Menyinkronkan NC dari sumber ini secara berkala, seperti yang didefinisikan dalam pSchedule.

DS_REPADD_USE_COMPRESSION

Menggunakan pemadatan saat mereplikasi. Ini menghemat bandwidth jaringan dengan mengorbankan overhead CPU di server sumber dan tujuan.

DS_REPADD_WRITEABLE

Membuat replika bisa-tulis; jika tidak, replika bersifat baca-saja.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian ERROR_SUCCESS.

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

Komentar

Persyaratan

Lihat juga

Fungsi Pengendali Domain dan Manajemen Replikasi

DsReplicaDel

DsReplicaModify

DsReplicaSync

DsReplicaUpdateRefs

JADWAL