Método IVssBackupComponents::SetBackupState (vsbackup.h)

  • Artículo

El método SetBackupState define una configuración general para una operación de copia de seguridad.

Sintaxis

HRESULT SetBackupState(
  [in] bool            bSelectComponents,
  [in] bool            bBackupBootableSystemState,
  [in] VSS_BACKUP_TYPE backupType,
  [in] bool            bPartialFileSupport
);

Parámetros

[in] bSelectComponents

Indica si una operación de copia de seguridad o restauración estará en modo componente.

La operación en modo componente admite la copia de seguridad selectiva de componentes individuales designados (que pueden permitir su exclusión) o solo admite la copia de seguridad de todos los archivos y componentes de un volumen.

El valor booleano es true si la operación se llevará a cabo en modo componente y false si no es así .

[in] bBackupBootableSystemState

Indica si se está realizando una copia de seguridad de estado del sistema de arranque.

[in] backupType

Valor de enumeración VSS_BACKUP_TYPE que indica el tipo de copia de seguridad que se va a realizar.

[in] bPartialFileSupport

Opcional. Si el valor de este parámetro es true, se habilita la compatibilidad parcial con archivos. El valor predeterminado de este argumento es false.

Valor devuelto

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

Valor Significado
S_OK
 Establezca correctamente el estado de copia de seguridad.
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 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.
VSS_E_INVALID_XML_DOCUMENT
 El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS.
VSS_E_UNEXPECTED
 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

Las aplicaciones deben llamar a SetBackupState antes de llamar a IVssBackupComponents::P repareForBackup.

Requisitos

Requisito Value
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

VSS_BACKUP_TYPE