Método IVssBackupComponents::SetContext (vsbackup.h)
El método SetContext 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 máscara de bits admitida (o OR bit a bit) de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES con un _VSS_SNAPSHOT_CONTEXT válido.
Valor devuelto
El valor devuelto predeterminado de este método es S_OK. A continuación se muestran los códigos de retorno válidos para este método.
| Value | Significado |
|---|---|
|
Establezca correctamente el contexto. |
|
Uno de los valores de parámetro no es válido. |
|
El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar. |
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.
Solo se puede llamar a SetContext una vez y se debe llamar antes de llamar a la mayoría de las funciones de VSS.
Para obtener más información sobre cómo el contexto establecido por IVssBackupComponents::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
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h) |
| Library | VssApi.lib |
Consulte también
IVssBackupComponents::D oSnapshotSet