IVssBackupComponents：：SetPreviousBackupStamp 方法 (vsbackup.h)

  • 项目

SetPreviousBackupStamp 方法设置早期备份操作的备份标记，差异备份操作或增量备份操作将基于该标记。

只能在备份操作期间调用 方法。

语法

HRESULT SetPreviousBackupStamp(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszPreviousBackupStamp
);

参数

[in] writerId

编写器标识符。

[in] ct

组件的类型。 有关可能的值，请参阅 VSS_COMPONENT_TYPE 。

[in] wszLogicalPath

包含组件的逻辑路径的以 Null 结尾的宽字符串。

有关详细信息，请参阅 组件的逻辑路径。

包含此处使用的逻辑路径的字符串的值应与使用 IVssBackupComponents：：AddComponent 将组件添加到备份集时使用的相同。

逻辑路径可以为 NULL。

[in] wszComponentName

包含组件名称的以 Null 结尾的宽字符串。

字符串不能为 NULL ，并且应包含与使用 IVssBackupComponents：：AddComponent 将组件添加到备份集时使用的组件名称相同。

[in] wszPreviousBackupStamp

要设置的备份标记。

返回值

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

值 含义
S_OK
 已成功设置以前的备份时间戳。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存或其他系统资源不足。
VSS_E_BAD_STATE
 备份组件对象未初始化，在还原操作期间调用了此方法，或者未按正确的顺序调用此方法。
VSS_E_OBJECT_NOT_FOUND
 备份组件不存在。
VSS_E_INVALID_XML_DOCUMENT
 XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_UNEXPECTED
 意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前不支持此值。 改用E_UNEXPECTED。

备注

应在 IVssBackupComponents：:P repareForBackup 之前调用此方法。

只有请求者才能调用此方法。

SetPreviousBackupStamp 设置的备份标记适用于组件中的所有文件及其具有的任何不可选择的子组件。

请求者仅将备份标记存储在备份组件文档中。 他们不能直接使用备份标记，不知道其格式，也不知道如何生成它们。

因此，应使用 IVssComponent：：GetBackupStamp 为正确的组件) 从早期备份操作 (存储的备份组件文档检索使用 SetPreviousBackupStamp 设置的值，或者从请求者存储的信息检索到其自己的内部记录中。

然后，编写器将使用 IVssComponent：：GetPreviousBackupStamp) (获取此值，并使用它将能够标记相应文件以参与增量备份或差异备份。

要求

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

另请参阅

IVssBackupComponents

IVssBackupComponents：:P reRestore