IVssCreateWriterMetadata 类 (vswriter.h)

IVssCreateWriterMetadata 接口是 C++ (而不是 COM) 接口，其中包含用于构造编写器元数据文档以响应 Identify 事件的方法。 它仅在 CVssWriter：：OnIdentify 方法中使用。

编写器对组件的添加和规范通过此接口进行管理。

构造后，编写器元数据文档是一个只读对象，请求者可查询有关编写器及其组件的信息。

IVssCreateWriterMetadata 定义以下方法。

方法	说明
AddAlternateLocationMapping	创建备用位置映射。
AddComponent	添加数据库或文件组作为要备份的组件。
AddComponentDependency	指示仅当由其他编写器管理的指定组件也参与备份或还原时，组件才参与备份或还原。
AddDatabaseFiles	指示与要备份的数据库关联的物理文件及其位置。
AddDatabaseLogFiles	指示与要备份的数据库关联的日志文件及其位置。
AddExcludeFiles	指定将从备份中排除的文件。
AddFilesToFileGroup	将指定的一个或多个文件添加到指定的文件组。
AddIncludeFiles	预留给系统使用。
GetDocument	预留给系统使用。
SaveAsXML	保存包含编写器元数据文档的文本字符串。
SetBackupSchema	设置备份架构 (备份的执行方式) 处理编写器文件时使用。
SetRestoreMethod	指示如何还原编写器数据。

方法

IVssCreateWriterMetadata 类包含以下方法。

IVssCreateWriterMetadata：：AddAlternateLocationMapping AddAlternateLocationMapping 方法为文件集创建备用位置映射。
IVssCreateWriterMetadata：：AddComponent AddComponent 方法将数据库或文件组添加为要备份的组件。
IVssCreateWriterMetadata：：AddComponentDependency AddComponentDependency 方法允许编写器指示它管理的组件具有显式编写器组件依赖项;也就是说，另一个编写器中的另一个组件必须用它进行备份和还原。
IVssCreateWriterMetadata：：AddDatabaseFiles AddDatabaseFiles 方法指示 (组成要备份的数据库组件的一个或多个指定文件) 的文件集。
IVssCreateWriterMetadata：：AddDatabaseLogFiles AddDatabaseLogFiles 方法指示与要备份的数据库关联的日志文件及其位置。
IVssCreateWriterMetadata：：AddExcludeFiles AddExcludeFiles 方法用于显式排除 (指定文件) 的文件集，否则在备份当前编写器的组件时可能会隐式包含这些文件集。
IVssCreateWriterMetadata：：AddFilesToFileGroup AddFilesToFileGroup 方法将 (指定文件集或) 的文件集添加到指定的文件组组件。
IVssCreateWriterMetadata：：AddIncludeFiles 不支持。 (IVssCreateWriterMetadata.AddIncludeFiles)
IVssCreateWriterMetadata：：GetDocument 不支持。 (IVssCreateWriterMetadata.GetDocument)
IVssCreateWriterMetadata：：SaveAsXML SaveAsXML 方法将包含编写器状态信息的编写器元数据文档保存到指定的字符串中。
IVssCreateWriterMetadata：：SetBackupSchema 编写器使用 SetBackupSchema 方法在其编写器元数据文档中指示它可以参与的备份操作的类型。
IVssCreateWriterMetadata：：SetRestoreMethod SetRestoreMethod 方法指示如何还原编写器的数据。

要求

最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	vswriter.h (包括 Vss.h、VsWriter.h)

另请参阅

IVssExamineWriterMetadata