IReplicaMetadata::ReportLiveItemByGlobalId
Reports that the specified item is active and should not be considered deleted.
Syntax
HRESULT ReportLiveItemByGlobalId(
const BYTE * pbGlobalId);
Parameters
- pbGlobalId
[in] The ID of the item to report as active.
Return Value
S_OK
E_POINTER
E_OUTOFMEMORY
SYNC_E_METADATA_ITEM_NOT_FOUND when the specified item cannot be found in the metadata store.
Remarks
This method is part of the delete detection service. An item is marked as active in the metadata store when IReplicaMetadata::SaveItemMetadata was called for a changed item, or when IReplicaMetadata::ReportLiveItemByIndexedFields or IReplicaMetadata::ReportLiveItemByGlobalId was called for an unchanged but still active item. A provider can call IReplicaMetadata::GetUnreportedItemsor IReplicaMetadata::GetUnreportedItemsByIndexedFields to get items that exist in the metadata store that are not reported as active. The provider can then mark these items as deleted in the metadata store.
For the implementation that is available through ISqlSyncMetadataStore, this method only has to be called on unmodified items because IReplicaMetadata::SaveItemMetadata implicitly marks updated items as active.