IVssBackupComponents::SetContext method

The SetContext method sets the context for subsequent shadow copy-related operations.

Syntax

HRESULT SetContext(
  LONG lContext
);

Parameters

lContext

The context to be set. The context must be one of the supported values of _VSS_SNAPSHOT_CONTEXT or a supported bit mask (or bitwise OR) of _VSS_VOLUME_SNAPSHOT_ATTRIBUTES with a valid _VSS_SNAPSHOT_CONTEXT.

Return Value

The default return value of this method is S_OK. The following are the valid return codes for this method.

Value Meaning
S_OK
Successfully set the context.
E_INVALIDARG
One of the parameter values is not valid.
VSS_E_BAD_STATE
The backup components object is not initialized, this method has been called during a restore operation, or this method has not been called within the correct sequence.
VSS_E_UNEXPECTED
Unexpected error. The error code is logged in the error log file. For more information, see Event and Error Handling Under VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP:  This value is not supported until Windows Server 2008 R2 and Windows 7. E_UNEXPECTED is used instead.

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.

SetContext can be called only once, and it must be called prior to calling most VSS functions.

For details on how the context set by IVssBackupComponents::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.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib

See Also

IVssBackupComponents

IVssBackupComponents::DoSnapshotSet

IVssBackupComponents::StartSnapshotSet

_VSS_SNAPSHOT_CONTEXT

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES