IChangeApplicationServices::BeginChangeApplication
開始處理一組變更。
HRESULT BeginChangeApplication(
ISyncKnowledge * pDestinationKnowledge,
IForgottenKnowledge * pDestinationForgottenKnowledge,
ISyncFilterInfo * pFilterInfo,
ISyncCallback * pSyncCallback,
IUnknown * pSourceDataRetriever,
IUnknown * pDestinationDataRetriever);
參數
- pDestinationKnowledge
[in] 目的地複寫的目前知識。
- pDestinationForgottenKnowledge
[in, unique] 目的地複寫目前的被遺忘知識。可以是 NULL。
- pFilterInfo
[in, unique] 目的地提供者所使用的篩選器相關資訊。可以是 NULL。
- pSyncCallback
[in, unique] 將會接收有關變更應用程式事件之通知的回呼。可以是 NULL。
- pSourceDataRetriever
[in] 可用來從來源複寫中擷取項目資料的物件。
- pDestinationDataRetriever
[in] 可用來從目的地複寫中擷取項目資料的物件。
傳回值
S_OK。
E_OUTOFMEMORY。
E_POINTER。
如果任何指定之知識物件的識別碼格式結構描述不符合初始化此物件時所指定的識別碼格式結構描述,則為 SYNC_E_ID_FORMAT_MISMATCH。
當此物件尚未初始化時,或已啟動變更應用程式,但無法在另一組變更上結束時,則為 SYNC_E_INVALID_OPERATION。
備註
此方法通常會為目的地提供者之 IKnowledgeSyncProvider::ProcessChangeBatch 方法所接收的每個變更批次呼叫一次。
在可以設定或計算知識,或者套用或報告變更之前,必須呼叫這個方法。