Método IVssBackupComponents::SetSelectedForRestore (vsbackup.h)
O método SetSelectedForRestore indica se o componente selecionável especificado está selecionado para restauração.
Sintaxe
HRESULT SetSelectedForRestore(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSelectedForRestore
);
Parâmetros
[in] writerId
Identificador do gravador.
[in] ct
Tipo do componente. Consulte VSS_COMPONENT_TYPE para obter os valores possíveis.
[in] wszLogicalPath
Cadeia de caracteres largos terminada em nulo que contém o caminho lógico do componente. Para obter mais informações, consulte Caminhos lógicos de componentes.
O valor da cadeia de caracteres que contém o caminho lógico usado aqui deve ser o mesmo usado quando o componente foi adicionado.
O caminho lógico pode ser NULL.
Não há restrições nos caracteres que podem aparecer em um caminho lógico não NULL .
[in] wszComponentName
Cadeia de caracteres largos terminada em nulo que contém o nome do componente.
A cadeia de caracteres não pode ser NULL e deve conter o mesmo nome de componente que foi usado quando o componente foi adicionado ao conjunto de backup usando IVssBackupComponents::AddComponent.
[in] bSelectedForRestore
Se o valor desse parâmetro for true, o componente selecionado foi selecionado para restauração. Se o valor for false, o componente selecionado não foi selecionado para restauração.
Retornar valor
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
Indicou com êxito que o componente especificado foi selecionado para ser restaurado. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta. |
|
O componente que está sendo selecionado não existe no Documento de Componentes de Backup ou uma instância dinâmica do gravador correspondente a esse componente não está em execução no 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. |
|
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
SetSelectedForRestore tem significado apenas para restaurações que ocorrem no modo de componente.
SetSelectedForRestore só pode ser chamado para componentes que foram adicionados explicitamente ao documento de backup no momento do backup usando IVssBackupComponents::AddComponent. A restauração de um componente que foi selecionado implicitamente para backup como parte de um conjunto de componentes deve ser feita chamando SetSelectedForRestore no componente ancestral mais próximo que foi adicionado ao documento. Se apenas os dados desse componente devem ser restaurados, isso deve ser feito por meio de IVssBackupComponents::AddRestoreSubcomponent; isso só poderá ser feito se o componente for selecionável para restauração (consulte Trabalhando com Selebilidade e Caminhos Lógicos).
Esse método deve ser chamado antes de IVssBackupComponents::P reRestore.
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 | vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |
Confira também
IVssBackupComponents::P reRestore