Método IVssComponent::GetAdditionalRestores (vswriter.h)

  • Artigo

O método GetAdditionalRestores é usado por um gravador durante operações de restauração incremental ou diferencial para determinar se um determinado componente exigirá operações de restauração adicionais para recuperá-lo completamente.

Um gravador ou um solicitante pode chamar esse método.

Sintaxe

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

Parâmetros

[out] pbAdditionalRestores

O endereço de uma variável alocada pelo chamador que recebe true se ocorrerem restaurações adicionais para o componente atual ou false caso contrário.

Valor retornado

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

Valor Significado
S_OK
 Retornou com êxito o valor do atributo.
S_FALSE
 O atributo especificado não tem um valor.
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_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 em VSS.

Comentários

O valor retornado por GetAdditionalRestores será false, a menos que durante uma operação de restauração um solicitante chame IVssBackupComponents::SetAdditionalRestores.

GetAdditionalRestores deve ser usado para marcar se for necessário usar mais de um conjunto de backup para restaurar completamente um componente. Primeiro, um componente pode ser recuperado restaurando dados de um backup completo e atualizando esses dados de um ou mais backups incrementais ou diferenciais subsequentes.

O método GetAdditionalRestores normalmente é usado por gravadores que dão suporte a um mecanismo de recuperação explícito como parte de seu manipulador de eventos PostRestore (CVssWriter::OnPostRestore)— por exemplo, o Exchange Server e aplicativos de banco de dados, como SQL Server. Para esses aplicativos, geralmente não é possível executar restaurações diferenciais, incrementais ou de log adicionais depois que essa recuperação é executada.

Portanto, se GetAdditionalRestores retornar true para um componente, esse gravador não deverá executar seu mecanismo de recuperação explícito e deverá esperar que outras restaurações diferenciais, incrementais ou de log sejam feitas.

Quando SetAdditionalRestores retornar false, depois que a restauração for concluída, ao manipular o evento PostRestore , o gravador poderá concluir sua operação de recuperação e ser colocado online novamente.

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

Confira também

IVssComponent