ISyncMetadataStoreSerializer Interface

Serializes and deserializes metadata for a replica between a canonical metadata file format and version-specific metadata storage service store formats.

interface ISyncMetadataStoreSerializer : IUnknown

Members

ISyncMetadataStoreSerializer methods Description

ISyncMetadataStoreSerializer::SerializeReplicaMetadata

Serializes for the specified replica the contents of a metadata storage service store to a destination stream in a canonical format.

ISyncMetadataStoreSerializer::DeserializeReplicaMetadata

Deserializes the contents of a canonical metadata file to a metadata storage service store. Optionally upgrades the metadata store format when the provider version changes.

ISyncMetadataStoreSerializer::GetSerializedReplicaId

Returns the replica ID for the replica whose metadata was serialized to the specified destination stream.

Requirements

Header: Metastore.h

Remarks

You can serialize the metadata file to a canonical format by using the ISyncMetadataStoreSerializer methods to interoperate among components of differing versions. For more information, see Accessing Metadata from Components with Different Versions.

You can serialize the metadata file to a canonical format by using the ISyncMetadataStoreSerializer methods. This upgrades the metadata store when the provider version changes. For more information, see Upgrading the Metadata Store Version.

To obtain an ISyncMetadataStoreSerializer object, pass IID_ISyncMetadataStoreSerializer to the QueryInterface method of an ISqlSyncMetadataStore Interface object.

The ISyncMetadataStoreSerializer interface has the following behaviors regarding concurrent serialization and deserialization operations for a metadata store:

  • Concurrent operations for a single replica's metadata are not supported, regardless of whether operations are executed in different processes or on different threads in the same process.

  • Concurrent serialization and deserialization operations for a metadata store are supported only if each operation affects a different replica's metadata and each operation is performed over a different connection.

  • Serialization and deserialization operations are not supported while a replica is synchronizing.

See Also

Concepts

Sync Framework Metadata Storage Service Components