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

Null 終止的字串，指定來源 DSA 的傳輸特定位址。 此來源伺服器是由字串名稱來識別，而不是由其 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

使用月臺間傳訊服務 （IMS） 傳輸從來源 DSA 同步處理，例如 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。

如果函式失敗，傳回值可以是下列其中一項。

言論

要求

另請參閱

域控制器和復寫管理功能

DsReplicaDel

DsReplicaModify

DsReplicaSync

DsReplicaUpdateRefs

SCHEDULE