Compartir a través de

Método IVssSoftwareSnapshotProvider::SetContext (vsprov.h)

  • Artículo

Establece el contexto para las operaciones posteriores relacionadas con la instantánea.

Sintaxis

HRESULT SetContext(
  [in] LONG lContext
);

Parámetros

[in] lContext

Contexto que se va a establecer. El contexto debe ser uno de los valores admitidos de _VSS_SNAPSHOT_CONTEXT o una combinación admitida de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES y _VSS_SNAPSHOT_CONTEXT valores.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
 El contexto se estableció correctamente.
E_ACCESSDENIED
 El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_BAD_STATE
 El contexto está inmovilizado y no se puede cambiar.

Comentarios

El contexto predeterminado para las instantáneas de VSS es VSS_CTX_BACKUP.

Windows XP: El único contexto admitido es el contexto predeterminado, VSS_CTX_BACKUP. Por lo tanto, llamar a SetContext en Windows XP devuelve E_NOTIMPL.

Para obtener más información sobre cómo el contexto establecido por SetContext afecta a cómo se crea y administra una instantánea, consulte Detalles de implementación para crear instantáneas.

Para obtener una explicación completa de los contextos de instantánea permitidos, consulte _VSS_SNAPSHOT_CONTEXT y _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsprov.h
Library VssApi.lib

Consulte también

IVssSoftwareSnapshotProvider