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

Artigo
08/27/2023

O método BackupComplete faz com que o VSS gere um evento BackupComplete , que sinaliza aos gravadores que o processo de backup foi concluído.

Sintaxe

HRESULT BackupComplete(
  [out] IVssAsync **ppAsync
);

Parâmetros

[out] ppAsync

Ponteiro indireto duplamente para uma instância IVssAsync .

Valor retornado

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

Valor	Significado
S_OK	Retornou com êxito um ponteiro para uma instância da interface IVssAsync . Consulte IVssAsync::QueryStatus para obter os valores válidos retornados pelo parâmetro pHrResult .
E_INVALIDARG	ppAsync não aponta para um ponteiro válido; ou seja, é NULL.
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 em 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.
VSS_E_UNEXPECTED_WRITER_ERROR	Ocorreu um erro inesperado durante a comunicação com os gravadores. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.

Comentários

Ao trabalhar no modo de componente (IVssBackupComponents::SetBackupState foi chamado com um argumento de componentes selecionados de TRUE), os gravadores podem determinar o sucesso ou a falha do backup de qualquer componente explicitamente incluído nos componentes do Documento de Componentes de Backup usando IVssComponent::GetBackupSucceeded. Portanto, um aplicativo de backup bem comportado (solicitante) deve chamar IVssBackupComponents::SetBackupSucceeded depois que cada componente tiver sido processado e antes de chamar BackupComplete.

Não chame esse método se a chamada para IVssBackupComponents::D oSnapshotSet falhou. Para obter mais informações sobre como os solicitantes usam DoSnapshotSet, SetBackupSucceeded e BackupComplete em uma operação de backup, consulte Visão geral das tarefas de pré-backup e visão geral do backup real de arquivos.

Essa operação é assíncrona. O chamador pode usar o método de interface QueryStatus na interface IVssAsync retornada para determinar o status da notificação.

Depois de chamar BackupComplete, os solicitantes devem chamar GatherWriterStatus para fazer com que a sessão de gravador seja definida como um estado concluído.

Nota Isso só é necessário no Windows Server 2008 com Service Pack 2 (SP2) e anterior.

O aplicativo de backup pode optar por anular o backup a qualquer momento depois que a cópia de sombra for criada chamando IVssAsync::Cancel.

O aplicativo de chamada é responsável por chamar IUnknown::Release para liberar os recursos mantidos pelo IVssAsync retornado quando ele não for mais necessário.

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