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