Compartir a través de

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

  • Artículo

Establece el contexto de 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 valores de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES y _VSS_SNAPSHOT_CONTEXT .

Valor devuelto

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

Value 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 un 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, vea 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

   
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vsprov.h
Library VssApi.lib

Consulte también

IVssFileShareSnapshotProvider