Интерфейс IItemMetadata

Статья
10/17/2009

Представляет метаданные, связанные с элементом в области синхронизации.

interface IItemMetadata : IUnknown

Элементы

Элементы IItemMetadata	Описание
IItemMetadata::GetGlobalId	Возвращает глобальный идентификатор элемента.
IItemMetadata::SetGlobalId	Задает глобальный идентификатор элемента.
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-разрядного беззнакового целочисленного поля.

Замечания

Метаданные элемента содержат версию создания, текущую версию, глобальный идентификатор и признак удаления элемента из хранилища элементов. В них могут также содержаться пользовательские поля, определенные в структуре CUSTOM_FIELD_DEFINITION, использованной при инициализации метаданных реплики.

Служба хранилища метаданных реализует интерфейс IItemMetadata. Чтобы получить экземпляр этой реализации IItemMetadata, сначала создайте объект ISqlCESyncMetadataStore. Затем создайте или получите объект IReplicaMetadata при помощи подходящего метода ISqlCESyncMetadataStore, а затем вызовите метод IReplicaMetadata::CreateNewItemMetadata, чтобы создать новую запись метаданных, или метод для поиска элемента, существующего в хранилище данных, например IReplicaMetadata::FindItemMetadataByGlobalId.

Реализация этого класса в службе хранилища метаданных не сохраняет изменения свойств на диск до тех пор, пока объект не будет передан методу IReplicaMetadata::SaveItemMetadata.

Системные требования

Заголовок: Metastore.h

См. также

Основные положения

Компоненты по службе хранилища метаданных Sync Framework
Доступ к метаданным реплики

Поделиться через