IItemMetadata 接口

表示与同步作用域中的项相关联的元数据。

interface IItemMetadata : IUnknown

成员

IItemMetadata 方法	说明
IItemMetadata::GetGlobalId	获取项的全局 ID。
IItemMetadata::SetGlobalId	设置项的全局 ID。
IItemMetadata::GetChangeVersion	获取对项所做的最新变更的版本。
IItemMetadata::SetChangeVersion	设置对项所做的最新变更的版本。
IItemMetadata::GetCreationVersion	获取项的创建版本。
IItemMetadata::SetCreationVersion	设置项的创建版本。
IItemMetadata::GetChangeUnitVersion	获取包含在项中的变更单位的版本。
IItemMetadata::SetChangeUnitVersion	设置包含在项中的变更单位的版本。
IItemMetadata::GetChangeUnitEnumerator	获取一个可用于枚举包含在此项中的变更单位的对象。
IItemMetadata::GetIsDeleted	获取一个指示项是否已从项存储区中删除的值。
IItemMetadata::MarkAsDeleted	将项标记为已从项存储区中删除。
IItemMetadata::ResurrectDeletedItem	还原先前标记为已从元数据存储区中删除的项。
IItemMetadata::TryGetFieldByteArray	获取字节数组字段的值。
IItemMetadata::TryGetFieldGuid	获取 GUID 字段的值。
IItemMetadata::TryGetFieldString	获取字符串字段的值。
IItemMetadata::TryGetFieldUInt8	获取 8 位无符号整数字段的值。
IItemMetadata::TryGetFieldUInt16	获取 16 位无符号整数字段的值。
IItemMetadata::TryGetFieldUInt32	获取 32 位无符号整数字段的值。
IItemMetadata::TryGetFieldUInt64	获取 64 位无符号整数字段的值。
IItemMetadata::SetFieldByteArray	设置字节数组字段的值。
IItemMetadata::SetFieldGuid	设置 GUID 字段的值。
IItemMetadata::SetFieldString	设置字符串字段的值。
IItemMetadata::SetFieldUInt8	设置 8 位无符号整数字段的值。
IItemMetadata::SetFieldUInt16	设置 16 位无符号整数字段的值。
IItemMetadata::SetFieldUInt32	设置 32 位无符号整数字段的值。
IItemMetadata::SetFieldUInt64	设置 64 位无符号整数字段的值。

备注

项的元数据中包含其创建版本、当前版本、全局 ID 和一个指示该项是否已从项存储区中删除的值。元数据还可以包含用于初始化副本元数据的 CUSTOM_FIELD_DEFINITION 结构所定义的自定义字段。

元数据存储服务实现 IItemMetadata。若要获取此 IItemMetadata 实现的一个实例，请首先创建一个 ISqlCESyncMetadataStore 对象。接下来，使用相应的 ISqlCESyncMetadataStore 方法创建或获取一个 IReplicaMetadata 对象，然后调用 IReplicaMetadata::CreateNewItemMetadata 以创建一个新的元数据条目，或者调用 IReplicaMetadata::FindItemMetadataByGlobalId 等方法以查找元数据存储区中已存在的项的元数据。

在该对象传递到 IReplicaMetadata::SaveItemMetadata 之前，此类的元数据存储服务实现不会将属性变更保存到磁盘中。

要求

**头文件：**Metastore.h

请参阅

概念

Sync Framework Metadata Storage Service 组件
访问副本元数据