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

Artículo
03/08/2023

El método SaveAsXML guarda el documento componentes de copia de seguridad que contiene la información de estado de un solicitante en una cadena especificada. Este documento XML, que contiene el documento componentes de copia de seguridad, siempre debe guardarse de forma segura como parte de una operación de copia de seguridad.

Sintaxis

HRESULT SaveAsXML(
  [in] BSTR *pbstrXML
);

Parámetros

[in] pbstrXML

Puntero a una cadena que se va a usar para almacenar el documento de componentes de copia de seguridad que contiene la información de estado de un solicitante.

Valor devuelto

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

Valor	Significado
S_OK	Guardó correctamente el documento XML como el valor del parámetro pbstrXML .
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_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

Para una operación de copia de seguridad típica, no se debe llamar a SaveAsXML hasta que los escritores y el solicitante terminen de modificar el documento componentes de copia de seguridad.

Los escritores pueden seguir modificando el documento de componentes de copia de seguridad hasta que su retorno correcto pueda controlar el evento PostSnapshot (CVssWriter::OnPostSnapshot) o, de forma equivalente, tras la finalización de IVssBackupComponents::D oSnapshotSet.

Los solicitantes deberán seguir modificando el documento componentes de copia de seguridad a medida que avanza la copia de seguridad. En concreto, un solicitante almacenará un registro componente por componente del éxito o error de la copia de seguridad mediante llamadas al método IVssBackupComponents::SetBackupSucceeded.

Una vez que el solicitante haya terminado de modificar el documento componentes de copia de seguridad, el solicitante debe usar SaveAsXML para guardar una copia del documento en el medio de copia de seguridad.

Un documento de componentes de copia de seguridad se puede guardar en puntos anteriores del ciclo de vida de una operación de copia de seguridad, por ejemplo, para admitir la generación de instantáneas transportables que se controlarán en máquinas remotas. (Consulte Importación de volúmenes de instantáneas transportables copiadas para obtener más información).

Sin embargo, nunca se debe llamar a SaveAsXML antes de IVssBackupComponents::P repareForBackup, ya que el solicitante y los escritores no rellenarán el documento de componentes de copia de seguridad.

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