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

  • Artigo

O método InitializeForBackup inicializa os metadados dos componentes de backup em preparação para backup.

Sintaxe

HRESULT InitializeForBackup(
  [in] BSTR bstrXML
);

Parâmetros

[in] bstrXML

Opcional. Durante as importações de cópias de sombra transportadas, esse parâmetro deve ser o documento original gerado ao criar a cópia de sombra salva e salvo usando IVssBackupComponents::SaveAsXML.

Retornar valor

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

Valor Significado
S_OK
 Inicializou com êxito o documento especificado para backup.
E_ACCESSDENIED
 O chamador não tem privilégios de backup suficientes ou não é um administrador.
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_INVALID_XML_DOCUMENT
 O documento XML não é válido. Verifique o log de eventos para obter detalhes. Para obter mais informações, consulte Tratamento de eventos e erros no VSS.
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

O documento XML fornecido a esse método inicializa o objeto IVssBackupComponents com metadados armazenados anteriormente por uma chamada para IVssBackupComponents::SaveAsXML. Os usuários não devem adulterar este documento de metadados.

Para obter mais informações sobre como usar InitializeForBackup com cópias de sombra transportáveis, consulte Importando volumes copiados de sombra transportável.

Requisitos

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

Confira também

IVssBackupComponents

IVssBackupComponents::SaveAsXML