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

Artigo
08/27/2023

O método SaveAsXML salva o Documento de Componentes de Backup que contém informações de estado de um solicitante em uma cadeia de caracteres especificada. Este documento XML, que contém o Documento de Componentes de Backup, sempre deve ser salvo com segurança como parte de uma operação de backup.

Sintaxe

HRESULT SaveAsXML(
  [in] BSTR *pbstrXML
);

Parâmetros

[in] pbstrXML

Ponteiro para uma cadeia de caracteres a ser usada para armazenar o Documento de Componentes de Backup que contém as informações de estado de um solicitante.

Valor retornado

Veja a seguir os códigos de retorno válidos para esse método.

Valor	Significado
S_OK	Salvou com êxito o documento XML como o valor do parâmetro pbstrXML .
E_INVALIDARG	Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY	O chamador está sem memória ou outros recursos do sistema.
VSS_E_BAD_STATE	O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta.
VSS_E_UNEXPECTED	Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros no VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado.

Comentários

Para uma operação de backup típica, SaveAsXML não deve ser chamado até que os gravadores e o solicitante terminem de modificar o Documento de Componentes de Backup.

Os gravadores podem continuar modificando o Documento de Componentes de Backup até que seu retorno bem-sucedido do tratamento do evento PostSnapshot (CVssWriter::OnPostSnapshot) ou equivalentemente após a conclusão de IVssBackupComponents::D oSnapshotSet.

Os solicitantes precisarão continuar modificando o Documento de Componentes de Backup à medida que o backup progride. Em particular, um solicitante armazenará um registro componente por componente do êxito ou falha do backup por meio de chamadas para o método IVssBackupComponents::SetBackupSucceeded .

Depois que o solicitante terminar de modificar o Documento de Componentes de Backup, o solicitante deverá usar SaveAsXML para salvar uma cópia do documento na mídia de backup.

Um Documento de Componentes de Backup pode ser salvo em pontos anteriores no ciclo de vida de uma operação de backup, por exemplo, para dar suporte à geração de cópias de sombra transportáveis a serem tratadas em computadores remotos. (Consulte Importando volumes copiados de sombra transportável para obter mais informações.)

No entanto, SaveAsXML nunca deve ser chamado antes de IVssBackupComponents::P repareForBackup, pois o Documento de Componentes de Backup não terá sido preenchido pelo solicitante e pelos gravadores.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)
Biblioteca	VssApi.lib