DsReplicaSyncW 函式（ntdsapi.h）

DsReplicaSync 函式會將目的地命名內容（NC）與其其中一個來源同步處理。

語法

NTDSAPI DWORD DsReplicaSyncW(
  [in] HANDLE     hDS,
  [in] LPCWSTR    NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      Options
);

參數

[in] hDS

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

[in] NameContext

常數 Null 終止字串的指標，指定目的地 NC 的辨別名稱。

[in] pUuidDsaSrc

復寫至目的地 NC 之來源 UUID 的指標。

[in] Options

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

DS_REPSYNC_ADD_REFERENCE

導致來源目錄系統代理程式（DSA）確認來源複寫到清單中有本機 DSA。如果沒有，則會新增本機 DSA。這可確保來源會傳送變更通知。

DS_REPSYNC_ALL_SOURCES

不支援此值。

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista 和 Windows Server 2003：從所有來源同步處理。

DS_REPSYNC_ASYNCHRONOUS_OPERATION

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

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista 和 Windows Server 2003：使用 DS_REPSYNC_ALL_SOURCES時需要 。

DS_REPSYNC_FORCE

即使目前已停用連結，也會同步處理。

DS_REPSYNC_FULL

從第一個更新序號（USN）開始同步處理。

DS_REPSYNC_INTERSITE_MESSAGING

使用 ISM 進行同步處理。

DS_REPSYNC_NO_DISCARD

即使類似的同步處理擱置中，也不會捨棄此同步處理要求。

DS_REPSYNC_PERIODIC

指出這項作業是系統管理員排程的定期同步處理要求。

DS_REPSYNC_URGENT

表示這項作業是標示為緊急更新的通知。

DS_REPSYNC_WRITEABLE

複本是可寫入的。否則，它是只讀的。

傳回值

如果函式順利執行其作業，則傳回值會 ERROR_SUCCESS。

如果函式失敗，傳回值就是其中一個標準 Win32 API 錯誤。

言論

DsReplicaSync 執行的伺服器稱為目的地。目的地命名內容是由來源系統 NTDS Settings 物件的 UUID 所識別的來源系統所 up-to日期。目的地系統必須已經設定，讓來源系統是接收複寫數據的來源系統之一。

注意強制手動同步處理可防止目錄服務正確設定複寫作業的優先順序。例如，同步處理新使用者可能會先行執行緊急同步處理，以提供最近鎖定使用者或新增信任密碼的存取權。如果您經常呼叫此 API，您可以將要求淹沒到網路，這可能會干擾其他復寫作業。基於這個理由，強烈建議此函式僅用於單一使用案例，而不是將它納入會定期使用的應用程式。

注意

ntdsapi.h 標頭會將 DsReplicaSync 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista
支援的最低伺服器	Windows Server 2008
目標平臺	窗戶
標頭	ntdsapi.h
連結庫	Ntdsapi.lib
DLL	Ntdsapi.dll