IVssComponent::SetRestoreMetadata 方法 (vswriter.h)

SetRestoreMetadata 方法为当前组件设置特定于编写器的元数据。

只有编写器才能调用此方法,并且只能在实现 CVssWriter::OnPreRestore 的上下文中调用此方法。

语法

HRESULT SetRestoreMetadata(
  [in] LPCWSTR wszRestoreMetadata
);

参数

[in] wszRestoreMetadata

调用方分配的 以 NULL 结尾的宽字符串,包含组件的还原元数据。

返回值

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

含义
S_OK
已成功设置项。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存不足或其他系统资源。
VSS_E_OBJECT_ALREADY_EXISTS
已为此组件编写私有元数据。
VSS_E_BAD_STATE
方法是在处理 PreRestore 事件的编写器上下文外部调用的。

注解

IVssComponent::SetRestoreMetadata 设置特定于编写器的专用元数据,编写器可在还原操作期间使用。

格式不需要符合任何 VSS 元数据规范。

要求

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

另请参阅

IVssComponent

IVssComponent::GetRestoreMetadata

IVssComponent::SetBackupMetadata