IItemMetadata-Schnittstelle

Stellt die Metadaten dar, die einem Element im Synchronisierungsbereich zugeordnet sind.

interface IItemMetadata : IUnknown

Member

IItemMetadata-Methoden	Beschreibung
IItemMetadata::GetGlobalId	Ruft die globale ID des Elements ab.
IItemMetadata::SetGlobalId	Legt die globale ID des Elements fest.
IItemMetadata::GetChangeVersion	Ruft die Version der letzten Änderung des Elements ab.
IItemMetadata::SetChangeVersion	Legt die Version der letzten Änderung des Elements fest.
IItemMetadata::GetCreationVersion	Ruft die Erstellungsversion des Elements ab.
IItemMetadata::SetCreationVersion	Legt die Erstellungsversion des Elements fest.
IItemMetadata::GetChangeUnitVersion	Ruft die Version einer Änderungseinheit ab, die in dem Element enthalten ist.
IItemMetadata::SetChangeUnitVersion	Legt die Version einer Änderungseinheit fest, die in dem Element enthalten ist.
IItemMetadata::GetChangeUnitEnumerator	Ruft ein Objekt ab, das verwendet werden kann, um die in diesem Element enthaltenen Änderungseinheiten aufzulisten.
IItemMetadata::GetIsDeleted	Ruft einen Wert ab, der angibt, ob das Element aus dem Elementspeicher gelöscht wurde.
IItemMetadata::MarkAsDeleted	Markiert ein Element als aus dem Elementspeicher gelöschtes Element.
IItemMetadata::ResurrectDeletedItem	Stellt ein Element wieder her, das zuvor im Metadatenspeicher als gelöschtes Element markiert war.
IItemMetadata::TryGetFieldByteArray	Ruft den Wert eines Bytearrayfelds ab.
IItemMetadata::TryGetFieldGuid	Ruft den Wert eines GUID-Felds ab.
IItemMetadata::TryGetFieldString	Ruft den Wert eines Zeichenfolgenfelds ab.
IItemMetadata::TryGetFieldUInt8	Ruft den Wert für ein Feld mit 8-Bit-Ganzzahl ohne Vorzeichen ab.
IItemMetadata::TryGetFieldUInt16	Ruft den Wert für ein Feld mit 16-Bit-Ganzzahl ohne Vorzeichen ab.
IItemMetadata::TryGetFieldUInt32	Ruft den Wert für ein Feld mit 32-Bit-Ganzzahl ohne Vorzeichen ab.
IItemMetadata::TryGetFieldUInt64	Ruft den Wert für ein Feld mit 64-Bit-Ganzzahl ohne Vorzeichen ab.
IItemMetadata::SetFieldByteArray	Legt den Wert eines Bytearrayfelds fest.
IItemMetadata::SetFieldGuid	Legt den Wert eines GUID-Felds fest.
IItemMetadata::SetFieldString	Legt den Wert eines Zeichenfolgenfelds fest.
IItemMetadata::SetFieldUInt8	Legt den Wert für ein Feld mit 8-Bit-Ganzzahl ohne Vorzeichen fest.
IItemMetadata::SetFieldUInt16	Legt den Wert für ein Feld mit 16-Bit-Ganzzahl ohne Vorzeichen fest.
IItemMetadata::SetFieldUInt32	Legt den Wert für ein Feld mit 32-Bit-Ganzzahl ohne Vorzeichen fest.
IItemMetadata::SetFieldUInt64	Legt den Wert für ein Feld mit 64-Bit-Ganzzahl ohne Vorzeichen fest.

Hinweise

Die Metadaten eines Elements enthalten die Erstellungsversion, die aktuelle Version, die globale ID sowie einen Wert, der angibt, ob das Element aus dem Elementspeicher gelöscht wurde. Die Metadaten können außerdem benutzerdefinierte Felder enthalten, die von der zum Initialisieren der Replikatmetadaten verwendeten CUSTOM_FIELD_DEFINITION-Struktur definiert werden.

Der Metadaten-Speicherdienst implementiert IItemMetadata. Um eine Instanz dieser Implementierung von IItemMetadata abzurufen, erstellen Sie zunächst ein ISqlCESyncMetadataStore-Objekt. Verwenden Sie anschließend die entsprechende ISqlCESyncMetadataStore-Methode, um ein IReplicaMetadata-Objekt zu erstellen oder abzurufen, und rufen Sie dann IReplicaMetadata::CreateNewItemMetadata auf, um einen neuen Metadateneintrag zu erstellen, oder rufen Sie eine Methode wie IReplicaMetadata::FindItemMetadataByGlobalId auf, um Metadaten für ein Element zu suchen, das bereits im Metadatenspeicher vorhanden ist.

Von der Implementierung des Metadaten-Speicherdiensts dieser Klasse werden keine Änderungen der Eigenschaften auf dem Datenträger gespeichert, bevor das Objekt an IReplicaMetadata::SaveItemMetadata übergeben wird.

Anforderungen

Header: Metastore.h

Siehe auch

Konzepte

Komponenten des Metadatenspeicherdiensts von Sync Framework
Zugreifen auf Replikatmetadaten