ISyncMetadataStoreSerializer Interface
Serializes and deserializes metadata for a replica between a canonical metadata file format and version-specific metadata storage service store formats.
Syntax
interface ISyncMetadataStoreSerializer : IUnknown
Members
ISyncMetadataStoreSerializer methods |
Description |
|---|---|
Serializes for the specified replica the contents of a metadata storage service store to a destination stream in a canonical format. |
|
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. |
|
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.