Método CVssWriter::OnPostRestore (vswriter.h)

O método OnPostRestore é chamado por um gravador após um evento PostRestore . Ele é usado para executar operações consideradas necessárias depois que os arquivos são restaurados no disco por um solicitante. No entanto, essas operações não podem modificar o Documento de Componentes de Backup.

OnPostRestore é um método virtual. Ele é implementado pela classe base CVssWriter , mas pode ser substituído por classes derivadas.

Sintaxe

bool OnPostRestore(
  [in] IVssWriterComponents *pComponent
);

Parâmetros

[in] pComponent

Um ponteiro para um objeto IVssWriterComponents passado pelo VSS para fornecer ao método acesso às informações de componente do gravador. O valor desse parâmetro poderá ser NULL se o solicitante não der suporte a componentes (se CVssWriter::AreComponentsSelected retornar false).

Retornar valor

Conforme implementado pela classe base, OnPostRestore sempre retorna true.

Qualquer outra implementação desse método deve retornar true , exceto no caso de um erro fatal. Se ocorrer um erro fatal, o método deverá chamar o método CVssWriter::SetWriterFailure para fornecer uma descrição da falha antes de retornar false. Se ocorrer um erro não fatal, o método ainda deverá chamar SetWriterFailure , mas retornar true. Se o erro for causado por um problema transitório, o método deverá especificar VSS_E_WRITERERROR_RETRYABLE na chamada para SetWriterFailure.

Em todos os casos em que ocorre uma falha, o método deve gravar um evento no log de eventos para relatar o motivo exato da falha.

Comentários

A implementação padrão desse método pela classe base CVssWriter retorna true sem executar nenhuma outra operação.

Se necessário, um gravador deve remover todos os arquivos temporários e liberar todos os recursos do sistema necessários para sua participação na restauração.

Os gravadores nunca devem gerar uma exceção desse método ou de qualquer outro método de retorno de chamada CVssWriter(Ex)::OnXxx .

Com a geração de um evento PostRestore , o Documento de Componentes de Backup de um solicitante se torna um documento somente leitura. Portanto, as tentativas de modificar o documento por meio da interface (por exemplo, chamar IVssComponent::SetRestoreMetadata) falharão nas implementações do usuário do OnPostRestore.

Se esse método chamar o método CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure ou CVssWriterEx2::SetWriterFailureEx , ele deverá fazê-lo no mesmo thread que chamou esse método. Para obter mais informações, consulte Tratamento de eventos do gravador.

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	vswriter.h (inclua Vss.h, VsWriter.h)
Biblioteca	VssApi.lib

Confira também

CVssWriter

IVssWriterComponents