IVssComponent::GetPreviousBackupStamp 方法 (vswriter.h)

GetPreviousBackupStamp 方法返回请求者在备份组件文档中加载的以前的备份标记。 编写器在决定文件是应参与差异备份操作还是增量备份操作时使用该值。

编写器或请求者都可以调用此方法。

语法

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

参数

[out] pbstrBackupStamp

指向包含上一个备份时间戳的字符串的指针,以便可以正确实现差异备份或增量备份。

返回值

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

含义
S_OK
已成功返回属性值。
S_FALSE
尚未设置以前的备份时间戳。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存不足或其他系统资源。
VSS_E_INVALID_XML_DOCUMENT
XML 文档无效。 有关详细信息,请查看事件日志。 有关详细信息,请参阅 VSS 下的事件和错误处理

注解

有关备份标记的详细信息,请参阅 备份复杂存储中的编写器角色备份复杂存储中的请求者角色

调用方应通过调用 SysFreeString 释放 pbstrBackupStamp 参数保留的内存。

如果没有以前的备份时间戳, GetPreviousBackupStamp 将返回S_FALSE。

返回的字符串引用组件中的所有文件及其具有的任何不可选择的子组件。

GetPreviousBackupStamp 检索到的备份标记由请求者使用 IVssBackupComponents::SetPreviousBackupStamp 设置

通常,用于设置 GetPreviousBackupStamp 找到的值的字符串是从存储的备份组件文档检索的,或者由请求者存储为其自身内部记录的一部分。

要求

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

另请参阅

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent