IReplicaMetadata::RemoveItemMetadataByGlobalId
Removes item metadata from the metadata store.
Syntax
HRESULT RemoveItemMetadataByGlobalId(
const BYTE * pbGlobalId);
Parameters
- pbGlobalId
[in] The ID of the item to remove.
Return Value
S_OK
E_POINTER
SYNC_E_METADATA_ITEM_NOT_FOUND if the item does not exist in the metadata store.
Remarks
The implementation of this method that is available through ISqlSyncMetadataStore immediately performs this operation on the store. If there is an outstanding explicit transaction, the operation will occur within that transaction and will be rolled back if the transaction is not committed or is rolled back.
Note
This is not the correct way to mark an item as a tombstone. To mark an item as a tombstone, call IItemMetadata::MarkAsDeleted. A provider uses RemoveItemMetadataByGlobalId to stop tracking metadata for an item and to remove the item completely from the metadata store, such as during tombstone cleanup.