IVssCreateWriterMetadata interface

The IVssCreateWriterMetadata interface is a C++ (not COM) interface containing methods to construct the Writer Metadata Document in response to an Identify event. It is used only in the CVssWriter::OnIdentify method.

The addition and specification of components by a writer is managed through this interface.

After it is constructed, the Writer Metadata Document is a read-only object that requesters query for information about a writer and its components.

IVssCreateWriterMetadata defines the following methods.

AddAlternateLocationMapping Creates an alternate location mapping.
AddComponent Adds a database or file group as a component to be backed up.
AddComponentDependency Indicates that a component participates in a backup or restore only if specified components managed by other writers also participate.
AddDatabaseFiles Indicates the physical files that are associated with a database to be backed up, as well as their location.
AddDatabaseLogFiles Indicates the log files that are associated with a database to be backed up, as well as their location.
AddExcludeFiles Specifies the files that will be excluded from the backup.
AddFilesToFileGroup Adds the specified file or files to the specified file group.
AddIncludeFiles Reserved for system use.
GetDocument Reserved for system use.
SaveAsXML Saves a text string containing the Writer Metadata Document.
SetBackupSchema Sets the backup schema (how a backup is to be executed) to be used when processing a writer's files.
SetRestoreMethod Indicates how writer data is to be restored.



The IVssCreateWriterMetadata interface inherits from the IUnknown interface but does not have additional members.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]


VsWriter.h (include Vss.h or VsWriter.h)



See also