Método IVssCreateExpressWriterMetadata::SetRestoreMethod (vswriter.h)
Especifica como os dados de um gravador expresso 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
Um VSS_RESTOREMETHOD_ENUM valor de enumeração que especifica o método de restauração a ser usado na operação de restauração. Esse parâmetro é necessário e não pode ser VSS_RME_UNDEFINED, VSS_RME_RESTORE_TO_ALTERNATE_LOCATION ou VSS_RME_CUSTOM.
[in] wszService
Um ponteiro para uma cadeia de caracteres largos 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 parâmetro 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
Um VSS_WRITERRESTORE_ENUM valor de enumeração que especifica se o gravador estará envolvido na restauração de seus dados. Esse parâmetro deve ser definido como VSS_WRE_NEVER.
[in] bRebootRequired
Um valor booliano que indica se uma reinicialização será necessária após a conclusão da operação de restauração.
Retornar valor
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 no VSS. |
|
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 no 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
Um gravador expresso pode definir apenas um método de restauração. Se o método de restauração não for substituído, todos os componentes do gravador expresso serão restaurados usando o mesmo método.
Os gravadores expressos 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 por 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 seu 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 poderá ser restaurado para um mapeamento de local alternativo se qualquer um dos seguintes itens 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.
Para obter mais informações sobre métodos de restauração, consulte Definindo 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 reinicialização de serviços durante uma operação de restauração, consulte Stop Services for Restore by Requesters.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |