Método IVssBackupComponents::SaveAsXML (vsbackup.h)
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 |
|---|---|
|
Guardó correctamente el documento XML como el valor del parámetro pbstrXML . |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
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
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 |
Consulte también
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::InitializeForBackup