ISyncChangeBatchBase::AddItemMetadataToGroup
將指定的項目變更加入至目前開啟的群組。
HRESULT AddItemMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwFlags,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
參數
- pbOwnerReplicaId
[in] 複寫識別碼，而且 pChangeVersion 和 pCreationVersion 在此複寫中必須有效。識別碼的格式必須與提供者的 ID_PARAMETERS 結構所指定的格式相符。
- pbItemId
[in] 此項目的識別碼。識別碼的格式必須與提供者的 ID_PARAMETERS 結構所指定的格式相符。
- pChangeVersion
[in] 此變更的版本。
- pCreationVersion
[in] 此項目的建立版本。
- dwFlags
[in] 指定此項目變更狀態的旗標。有關旗標的值，請參閱 SYNC_CHANGE_FLAG 旗標。
- dwWorkForChange
[in] 此變更的工作量估計值。此值是用於變更套用期間，向應用程式報告已完成的工作量。
- ppChangeBuilder
[out] 傳回用來將變更單位資訊加入到變更的物件。
傳回值
S_OK
如果 dwFlags 包含無效的旗標值，則為 E_INVALIDARG。
如果沒有群組為開啟，或者先前已將空群組加入到此批次，則為 SYNC_E_INVALID_OPERATION。
如果已排序群組為開啟，而且 pbItemId 小於先前加入群組之項目的項目識別碼，或小於開啟群組時指定的項目識別碼，則為 SYNC_E_RANGE_OUT_OF_ORDER。
如果 ISyncChangeBatchBase 物件已傳送給變更套用者或傳送給同步處理工作階段，或者此物件是使用 IProviderSyncServices::DeserializeChangeBatch 或 IProviderSyncServices::DeserializeFullEnumerationChangeBatch 建立的，則為 SYNC_E_CHANGE_BATCH_IS_READ_ONLY。
請參閱
參考
ISyncChangeBatchBase 介面
SYNC_VERSION 結構