IReplicaMetadata2::GetFilteredItemBatchVersions
Gets a filtered batch of changes that contains the versions of items and change units that are stored in this replica. These items and change units correspond to the items and change units that are referred to in a batch of changes that is sent from another provider.
Syntax
HRESULT GetFilteredItemBatchVersions(
ISyncChangeBatch * pRemoteSyncChangeBatch,
IChangeBatchCallback * pCallback,
IEnumSyncChanges ** ppLocalVersionsEnum);
Parameters
Term |
Definition |
pRemoteSyncChangeBatch |
[in] The batch of changes sent from another provider that is about to be applied to the item store that is associated with this replica. |
pCallback |
[in, unique] A callback interface that is called to determine whether an item should be added to the batch. |
ppLocalVersionsEnum |
[out] Returns a filtered batch of changes that contains the versions of items and change units that are stored in this replica. |
Return Value
S_OK
E_POINTER
Remarks
This method helps a synchronization provider implement its IKnowledgeSyncProvider::ProcessChangeBatch method when the destination provider filters changes.
Change appliers use the versions in the batch of changes that are returned from this method for conflict detection.
Notes for Implementers
The change batch that is returned from this method must contain one entry for every entry in pRemoteSyncChangeBatch, including change unit entries, except when pCallback indicates that the entry should not be included. If an item exists in the item store and is included by the filter, its entry must contain the version information for this replica. If an item that is included by the filter does not exist, its entry must contain 0 for its version and its SYNC_CHANGE_FLAG_DOES_NOT_EXIST flag must be set.