Método IVssCreateWriterMetadata::SetRestoreMethod (vswriter.h)
O método SetRestoreMethod indica como os dados do gravador devem ser restaurados.
Sintaxe
HRESULT SetRestoreMethod(
[in] VSS_RESTOREMETHOD_ENUM method,
[in] LPCWSTR wszService,
[in] LPCWSTR wszUserProcedure,
[in] VSS_WRITERRESTORE_ENUM writerRestore,
[in] bool bRebootRequired
);
Parâmetros
[in] method
VSS_RESTOREMETHOD_ENUM valor que especifica o método que será usado na operação de restauração.
[in] wszService
Um ponteiro para uma cadeia de caracteres larga que contém o nome de um serviço que deve ser interrompido antes de uma operação de restauração e, em seguida, iniciado após a operação de restauração ocorrer, se o valor do método for VSS_RME_STOP_RESTORE_START ou VSS_RME_RESTORE_STOP_START.
Se o valor do método não for VSS_RME_STOP_RESTORE_START ou VSS_RME_RESTORE_STOP_START, esse argumento não será usado e deverá ser definido como NULL.
[in] wszUserProcedure
Reservado para uso futuro. O valor desse parâmetro sempre deve ser definido como NULL.
[in] writerRestore
VSS_WRITERRESTORE_ENUM valor que especifica se o gravador estará envolvido na restauração de seus dados.
Os gravadores expressos devem definir esse parâmetro como VSS_WRE_NEVER.
[in] bRebootRequired
Booliano indicando se uma reinicialização será necessária após a conclusão da operação de restauração.
Valor retornado
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
A operação foi bem-sucedida. |
|
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. |
|
O chamador especificou um valor VSS_WRITERRESTORE_ENUM que não tem suporte para gravadores expressos. |
|
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. |
Comentários
Há um único método de restauração definido para um gravador. Se o método de restauração não for substituído, todos os componentes do gravador serão restaurados usando o mesmo método.
Os gravadores substituem o método de restauração em uma base componente por componente definindo um destino de restauração, normalmente durante o tratamento de um evento PreRestore (CVssWriter::OnPreRestore).
É importante observar que, apesar de os métodos de restauração serem aplicados em todo o gravador, os métodos são implementados por componente. Por exemplo, se o método especificado pelo parâmetro de método for VSS_RME_RESTORE_IF_CAN_REPLACE, todos os arquivos no componente serão restaurados para o local original se todos eles puderem ser substituídos sem que ocorra um erro. Caso contrário, eles serão restaurados para seu local alternativo se um for especificado.
Um arquivo sempre deverá ser restaurado para o mapeamento de localização alternativo se um dos seguintes procedimentos for verdadeiro:
- O método de restauração (definido no momento do backup) é VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
- Seu destino de restauração foi definido (no momento da restauração) como VSS_RT_ALTERNATE.
Um arquivo poderá ser restaurado para um mapeamento de local alternativo se um dos seguintes procedimentos for verdadeiro:
- O método de restauração é VSS_RME_RESTORE_IF_NOT_THERE e uma versão do arquivo já está presente no disco.
- O método de restauração é VSS_RME_RESTORE_IF_CAN_REPLACE e uma versão do arquivo está presente no disco e não pode ser substituída.
Um mapeamento de local alternativo é usado somente durante uma operação de restauração e não deve ser confundido com um caminho alternativo, que é usado somente durante uma operação de backup.
Para obter mais informações sobre métodos de restauração, consulte Configurando métodos de restauração do VSS.
Se o método de restauração for VSS_RME_STOP_RESTORE_START ou VSS_RME_RESTORE_STOP_START, o nome correto do serviço deverá ser fornecido como o argumento wszService . Para obter informações sobre a participação do gravador na interrupção e na reinicialização dos serviços durante uma operação de restauração, consulte Parando serviços para restauração por solicitantes.
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 |