ISyncChangeBatchBase::AddItemMetadataToGroup
Aggiunge una modifica dell'elemento specificata al gruppo attualmente aperto.
HRESULT AddItemMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwFlags,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
Parametri
- pbOwnerReplicaId
[in] ID della replica in cui pChangeVersion e pCreationVersion sono validi. Il formato dell'ID deve corrispondere al formato specificato dalla struttura ID_PARAMETERS del provider.
- pbItemId
[in] ID dell'elemento. Il formato dell'ID deve corrispondere al formato specificato dalla struttura ID_PARAMETERS del provider.
- pChangeVersion
[in] Versione di questa modifica.
- pCreationVersion
[in] Versione di creazione dell'elemento.
- dwFlags
[in] Flag che specificano lo stato della modifica dell'elemento. Per i valori dei flag, vedere Flag SYNC_CHANGE_FLAG.
- dwWorkForChange
[in] Stima di lavoro per la modifica. Questo valore viene utilizzato durante l'applicazione delle modifiche per segnalare il lavoro completato all'applicazione.
- ppChangeBuilder
[out] Restituisce un oggetto che può essere utilizzato per aggiungere informazioni sull'unità di modifica alla modifica.
Valore restituito
S_OK
E_INVALIDARG se dwFlags contiene un valore di flag non valido.
SYNC_E_INVALID_OPERATION se non vi è nessun gruppo aperto o un gruppo vuoto è stato precedentemente aggiunto al batch.
SYNC_E_RANGE_OUT_OF_ORDER se un gruppo ordinato viene aperto e pbItemId è inferiore all'ID dell'elemento precedente aggiunto al gruppo o inferiore all'ID dell'elemento specificato quando il gruppo è stato aperto.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY se l'oggetto ISyncChangeBatchBase è stato inviato a un oggetto di applicazione modifiche o alla sessione di sincronizzazione oppure se l'oggetto è stato creato tramite IProviderSyncServices::DeserializeChangeBatch o IProviderSyncServices::DeserializeFullEnumerationChangeBatch.
Vedere anche
Riferimento
Interfaccia ISyncChangeBatchBase
Struttura SYNC_VERSION