DsReplicaModifyW 函式 （ntdsapi.h）

DsReplicaModify 函式會修改目的地命名內容的現有復寫來源參考。

語法

NTDSAPI DWORD DsReplicaModifyW(
  [in] HANDLE          hDS,
  [in] LPCWSTR         NameContext,
  [in] const UUID      *pUuidSourceDsa,
  [in] LPCWSTR         TransportDn,
  [in] LPCWSTR         SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           ReplicaFlags,
  [in] DWORD           ModifyFields,
  [in] DWORD           Options
);

參數

[in] hDS

包含從 DSBind 或 DSBindWithCred 函式取得的目錄服務句柄。

[in] NameContext

常數 Null 終止字串的指標，指定目的地命名內容 （NC） 的辨別名稱 （DN）。

[in] pUuidSourceDsa

來源目錄系統代理程式的 UUID 指標。 如果ModifyFields 不包含 DS_REPMOD_UPDATE_ADDRESS ，而且 sourceDsaAddress 未 NULL，此參數可能是 null。

[in] TransportDn

保留供日後使用。 NULL 以外的任何值 會導致傳回 ERROR_NOT_SUPPORTED。

[in] SourceDsaAddress

常數 Null 終止的 Unicode 字串指標，指定來源 DSA 的傳輸特定位址。 如果 pUuidSourceDsa 未 NULL，而且 ModifyFields 不包含 DS_REPMOD_UPDATE_ADDRESS，則會忽略此參數。

[in] pSchedule

包含複寫來源複寫排程數據的 SCHEDULE 結構的指標。 此參數是選擇性的，如果沒有使用，則可以 NULL。 如果modifyFields 包含 DS_REPMOD_UPDATE_SCHEDULE 旗標，則需要此參數。

[in] ReplicaFlags

此參數是用來控制複寫行為，而且可以採用下列值。

DS_REPL_NBR_SYNC_ON_STARTUP

當目的地伺服器開機時，會嘗試從這個來源複寫此命名內容。 這通常只適用於網站內的鄰居。

DS_REPL_NBR_DO_SCHEDULED_SYNCS

依排程執行複寫。 此旗標通常會設定，除非此命名內容和來源的排程為「永不」，也就是空的排程。

DS_REPL_NBR_TWO_WAY_SYNC

如果設定，表示輸入複寫完成時，目的地伺服器必須告訴來源伺服器以反向方向同步處理。 這項功能用於撥號案例，其中只有兩部伺服器中只有一部可以起始撥號連線。 例如，此選項會用於公司總部和分公司，其中分公司會透過因特網聯機到公司總部，方法是透過撥號 ISP 連線。

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS

此芳鄰設定為停用通知型同步處理。 在月臺內，域控制器會根據發生變更時的通知彼此同步處理。 此設定可防止此芳鄰執行由通知觸發的同步處理。 芳鄰仍會根據其排程或回應手動要求的同步處理來執行同步處理。

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC

此芳鄰設定為不會根據其排程執行同步處理。 此芳鄰執行同步處理的唯一方式是回應變更通知或手動要求的同步處理。

DS_REPL_NBR_COMPRESS_CHANGES

從這個來源收到的變更將會壓縮。 這通常只有在來源伺服器位於不同的月臺時才會設定。

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

不應從此來源接收任何變更通知。 這通常只有在來源伺服器位於不同的月臺時才會設定。

[in] ModifyFields

指定應該修改哪些欄位。 ModifyFields中至少必須指定一個字段。 此參數可以是下列值的組合。

DS_REPMOD_UPDATE_ADDRESS

更新與參考伺服器相關聯的位址。

DS_REPMOD_UPDATE_FLAGS

更新與複本相關聯的旗標。

DS_REPMOD_UPDATE_RESULT

未使用。 目前不支援指定結果值的更新。 結果值預設為 0。

DS_REPMOD_UPDATE_SCHEDULE

更新與複本相關聯的定期複寫排程。

DS_REPMOD_UPDATE_TRANSPORT

更新與複本相關聯的傳輸。

[in] Options

傳遞用來處理要求的其他數據。 此參數可以是下列值的組合。

DS_REPMOD_ASYNCHRONOUS_OPERATION

以異步方式執行這項作業。

DS_REPMOD_WRITEABLE

表示要修改的複本可以寫入其中。

傳回值

如果函式成功，則傳回值會 ERROR_SUCCESS。

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

言論

要求

另請參閱

域控制器和復寫管理功能

DsReplicaAdd

DsReplicaDel

DsReplicaSync

DsReplicaUpdateRefs

SCHEDULE