IItemMetadata Interface
Represents the metadata that is associated with an item in the synchronization scope.
interface IItemMetadata : IUnknown
Members
| IItemMetadata methods | Description |
|---|---|
Gets the global ID of the item. |
|
Sets the global ID of the item. |
|
Gets the version of the most recent change made to the item. |
|
Sets the version of the most recent change made to the item. |
|
Gets the creation version of the item. |
|
Sets the creation version of the item. |
|
Gets the version of a change unit that is contained in the item. |
|
Sets the version of a change unit that is contained in the item. |
|
Gets an object that can be used to enumerate the change units that are contained in this item. |
|
Gets a value that indicates whether the item was deleted from the item store. |
|
Marks an item as deleted from the item store. |
|
Restores an item that was previously marked as deleted in the metadata store. |
|
Gets the value of a byte array field. |
|
Gets the value of a GUID field. |
|
Gets the value of a string field. |
|
Gets the value of an 8-bit unsigned integer field. |
|
Gets the value of a 16-bit unsigned integer field. |
|
Gets the value of a 32-bit unsigned integer field. |
|
Gets the value of a 64-bit unsigned integer field. |
|
Sets the value of a byte array field. |
|
Sets the value of a GUID field. |
|
Sets the value of a string field. |
|
Sets the value of an 8-bit unsigned integer field. |
|
Sets the value of a 16-bit unsigned integer field. |
|
Sets the value of a 32-bit unsigned integer field. |
|
Sets the value of a 64-bit unsigned integer field. |
Remarks
The metadata for an item contains its creation version, current version, global ID, and a value that indicates whether the item has been deleted from the item store. The metadata can also contain custom fields as defined by the CUSTOM_FIELD_DEFINITION structure that is used to initialize the replica metadata.
Metadata Storage Service implements IItemMetadata. To obtain an instance of this implementation of IItemMetadata, first create an ISqlCESyncMetadataStore object. Then, create or get an IReplicaMetadata object by using the appropriate ISqlCESyncMetadataStore method, and then call IReplicaMetadata::CreateNewItemMetadata to create a new metadata entry, or a method such as IReplicaMetadata::FindItemMetadataByGlobalId to find metadata for an item that already exists in the metadata store.
The Metadata Storage Service implementation of this class does not save property changes to the disk until the object is passed to IReplicaMetadata::SaveItemMetadata.
Requirements
Header: Metastore.h