IVssBackupComponents::FreeWriterMetadata 方法 (vsbackup.h)

FreeWriterMetadata 方法释放在调用 IVssBackupComponents::GatherWriterMetadata 时分配的系统资源。

语法

HRESULT FreeWriterMetadata();

返回值

下面是此方法的有效返回代码。

含义
S_OK
已成功释放编写器元数据。
VSS_E_BAD_STATE
备份组件对象未初始化,在还原操作期间调用了此方法,或者尚未在正确的顺序中调用此方法。

注解

完成 IVssBackupComponents::GatherWriterMetadata 之前,绝不应调用此方法。 在元数据收集完成之前调用 方法的结果未定义。

释放编写器元数据后, IVssBackupComponents 接口的当前实例无法恢复该元数据。 需要创建 IVssBackupComponents 的新实例,并再次调用 IVssBackupComponents::GatherWriterMetadata 方法。

要求

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

另请参阅

IVssBackupComponents

IVssBackupComponents::GatherWriterMetadata