IVssSoftwareSnapshotProvider::SetContext 方法 (vsprov.h)

设置后续卷影复制相关操作的上下文。

语法

HRESULT SetContext(
  [in] LONG lContext
);

参数

[in] lContext

要设置的上下文。 上下文必须是 _VSS_SNAPSHOT_CONTEXT 支持的值之一,或者是 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES_VSS_SNAPSHOT_CONTEXT 值的支持组合。

返回值

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

含义
S_OK
已成功设置上下文。
E_ACCESSDENIED
调用方没有足够的备份权限或不是管理员。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存不足或其他系统资源。
VSS_E_BAD_STATE
上下文已冻结,无法更改。

注解

VSS 卷影副本的默认上下文为VSS_CTX_BACKUP。

Windowsxp: 唯一受支持的上下文是默认上下文,VSS_CTX_BACKUP。 因此,在 Windows XP 下调用 SetContext 将返回E_NOTIMPL。

有关 SetContext 设置的上下文如何影响卷影副本的创建和管理方式的详细信息,请参阅 创建卷影副本的实现详细信息

有关允许的卷影复制上下文的完整讨论,请参阅 _VSS_SNAPSHOT_CONTEXT_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 vsprov.h
Library VssApi.lib

另请参阅

IVssSoftwareSnapshotProvider