IVssComponent：：SetBackupMetadata 方法 (vswriter.h)

SetBackupMetadata 方法使用组件设置备份元数据。

编写器只能在备份操作期间调用此方法。

语法

HRESULT SetBackupMetadata(
  [in] LPCWSTR wszData
);

[in] wszData

包含备份元数据的 以 NULL 结尾的宽字符串。

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

值	含义
S_OK	已成功设置项。
E_INVALIDARG	其中一个参数值无效。
E_OUTOFMEMORY	调用方内存或其他系统资源不足。
VSS_E_OBJECT_ALREADY_EXISTS	已为此组件编写专用元数据。
VSS_E_BAD_STATE	编写器未调用此方法，或者，如果由编写器调用，则在备份操作期间未调用此方法，或者在处理 BackupComplete 或 BackupShutdown 事件时调用此方法。

SetBackupMetadata 设置特定于编写器的专用元数据，用于描述备份操作。

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