DsReplicaSyncA 函式 (ntdsapi.h)

發行項
02/29/2024

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

語法

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

參數

[in] hDS

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

[in] NameContext

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

[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 所識別。目的地系統必須已設定，以便來源系統是接收複寫數據的其中一個系統。

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

注意

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

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	ntdsapi.h
程式庫	Ntdsapi.lib
Dll	Ntdsapi.dll