DsReplicaAddA 函式 (ntdsapi.h)
DsReplicaAdd 函式會將複寫來源參考新增至目的地命名內容。
語法
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
);
參數
[in] hDS
包含從 DSBind 或 DSBindWithCred 函式取得的目錄服務句柄。
[in] NameContext
以 null 結尾的字串，指定要加入複本之目的地命名內容 (NC) 的辨別名稱 (DN) 。 目的地 NC 記錄必須存在於本機做為物件、具現化或未具現化，或是參考虛設，例如具有 GUID 的虛設專案。
[in] SourceDsaDn
Null 終止的字串，指定來源目錄系統代理程式的 NTDS-DSA 物件 DN。 如果 Options 包含 DS_REPADD_ASYNCHRONOUS_REPLICA，則需要此參數;否則會忽略它。
[in] TransportDn
Null 終止的字串，指定 InterSiteTransport 物件的 DN，代表用來與來源伺服器通訊的傳輸。 如果 Options 包含 DS_REPADD_INTERSITE_MESSAGING，則需要此參數;否則會忽略它。
[in] SourceDsaAddress
指定來源 DSA 之傳輸特定位址的 Null 終止字串。 此來源伺服器是以字串名稱來識別，而不是透過其 UUID 來識別。 適用於 SourceDsaAddress 的字串名稱通常是以 GUID 為基礎的 DNS 名稱，其中名稱的 GUID 部分是來源伺服器的 NTDS-DSA 物件的 GUID。
[in] pSchedule
包含複寫來源之復寫排程數據的 SCHEDULE 結構的指標。 此參數是選擇性的，如果沒有使用，則可以是 NULL 。
[in] Options
傳遞要用來處理要求的其他數據。 此參數可以是下列值的組合。
DS_REPADD_ASYNCHRONOUS_OPERATION
以異步方式執行這項作業。
DS_REPADD_ASYNCHRONOUS_REPLICA
不會復寫 NC。 相反地，請儲存足夠的狀態數據，以便稍後進行複寫。
DS_REPADD_DISABLE_NOTIFICATION
從這個來源停用 NC 的通知型同步處理。 這應該是暫時性狀態。 使用 DS_REPADD_NEVER_NOTIFY 永久停用同步處理。
DS_REPADD_DISABLE_PERIODIC
從這個來源停用 NC 的定期同步處理。
DS_REPADD_INITIAL
啟動 DSA 時，同步處理來自此來源的 NC。
DS_REPADD_INTERSITE_MESSAGING
使用月臺間傳訊服務從來源 DSA 同步處理 (IMS) 傳輸，例如 SMTP，而不是使用原生目錄服務 RPC。
DS_REPADD_NEVER_NOTIFY
停用此來源的變更通知。 設定此旗標時，來源不會在發生變更時通知目的地。 建議針對可能透過 WAN 連結進行的所有月臺間復寫。
這應該是永久狀態;使用 DS_REPADD_DISABLE_NOTIFICATION 暫時停用通知。
DS_REPADD_PERIODIC
定期同步處理來自此來源的 NC，如 pSchedule 中所定義。
DS_REPADD_USE_COMPRESSION
複寫時會使用壓縮。 這可節省網路頻寬，代價是來源和目的地伺服器的CPU額外負荷。
DS_REPADD_WRITEABLE
建立可寫入的複本;否則，複本是只讀的。
傳回值
如果函式成功，傳回值會 ERROR_SUCCESS。
如果函式失敗，傳回值可以是下列其中一項。
備註
注意
ntdsapi.h 標頭會將 DsReplicaAdd 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | ntdsapi.h |
| 程式庫 | Ntdsapi.lib |
| Dll | Ntdsapi.dll |