Skip to content

Latest commit

 

History

History
149 lines (126 loc) · 4.01 KB

nf-vsprov-ivsssoftwaresnapshotprovider-setcontext.md

File metadata and controls

149 lines (126 loc) · 4.01 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:vsprov.IVssSoftwareSnapshotProvider.SetContext
IVssSoftwareSnapshotProvider::SetContext (vsprov.h)
Sets the context for subsequent shadow copy-related operations.
IVssSoftwareSnapshotProvider interface
SetContext method
IVssSoftwareSnapshotProvider.SetContext
IVssSoftwareSnapshotProvider::SetContext
SetContext
SetContext method
SetContext method
IVssSoftwareSnapshotProvider interface
base.ivsssoftwaresnapshotprovider_setcontext
vsprov/IVssSoftwareSnapshotProvider::SetContext
base\ivsssoftwaresnapshotprovider_setcontext.htm
base
5e2ddd7e-dcb8-4a13-8889-2d0e9dd102f2
12/05/2018
IVssSoftwareSnapshotProvider interface,SetContext method, IVssSoftwareSnapshotProvider.SetContext, IVssSoftwareSnapshotProvider::SetContext, SetContext, SetContext method, SetContext method,IVssSoftwareSnapshotProvider interface, base.ivsssoftwaresnapshotprovider_setcontext, vsprov/IVssSoftwareSnapshotProvider::SetContext
vsprov.h
Windows
Windows Vista [desktop apps only]
Windows Server 2003 [desktop apps only]
VssApi.lib
Windows
19H1
IVssSoftwareSnapshotProvider::SetContext
vsprov/IVssSoftwareSnapshotProvider::SetContext
c++
APIRef
kbSyntax
COM
VssApi.lib
VssApi.dll
IVssSoftwareSnapshotProvider.SetContext

IVssSoftwareSnapshotProvider::SetContext

-description

Sets the context for subsequent shadow copy-related operations.

-parameters

-param lContext [in]

The context to be set. The context must be one of the supported values of _VSS_SNAPSHOT_CONTEXT or a supported combination of _VSS_VOLUME_SNAPSHOT_ATTRIBUTES and _VSS_SNAPSHOT_CONTEXT values.

-returns

The following are the valid return codes for this method.

Value Meaning
S_OK
The context was set successfully.
E_ACCESSDENIED
The caller does not have sufficient backup privileges or is not an administrator.
E_INVALIDARG
One of the parameter values is not valid.
E_OUTOFMEMORY
The caller is out of memory or other system resources.
VSS_E_BAD_STATE
The context is frozen and cannot be changed.

-remarks

The default context for VSS shadow copies is VSS_CTX_BACKUP.

Windows XP:  The only supported context is the default context, VSS_CTX_BACKUP. Therefore, calling SetContext under Windows XP returns E_NOTIMPL.

For more information about how the context that is set by SetContext affects how a shadow copy is created and managed, see Implementation Details for Creating Shadow Copies.

For a complete discussion of the permitted shadow copy contexts, see _VSS_SNAPSHOT_CONTEXT and _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

-see-also

IVssSoftwareSnapshotProvider