Método IVssComponent::GetAdditionalRestores (vswriter.h)
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 |
|---|---|
|
Retornou com êxito o valor do atributo. |
|
O atributo especificado não tem um valor. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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 |