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

  • Artículo

El método InitializeForBackup inicializa los metadatos de los componentes de copia de seguridad como preparación para la copia de seguridad.

Sintaxis

HRESULT InitializeForBackup(
  [in] BSTR bstrXML
);

Parámetros

[in] bstrXML

Opcional. Durante las importaciones de instantáneas transportadas, este parámetro debe ser el documento original generado al crear la instantánea guardada y guardarla mediante IVssBackupComponents::SaveAsXML.

Valor devuelto

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

Valor Significado
S_OK
 Inicializó correctamente el documento especificado para la copia de seguridad.
E_ACCESSDENIED
 El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un administrador.
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, vea 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, vea 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 documento XML proporcionado a este método inicializa el objeto IVssBackupComponents con metadatos almacenados previamente mediante una llamada a IVssBackupComponents::SaveAsXML. Los usuarios no deben alterar este documento de metadatos.

Para obtener más información sobre cómo usar InitializeForBackup con instantáneas transportables, vea Importación de volúmenes de instantáneas transportables.

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

IVssBackupComponents::SaveAsXML