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
S_OK	Indicou com êxito que o componente especificado foi selecionado para ser restaurado.
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_BAD_STATE	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.
VSS_E_OBJECT_NOT_FOUND	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.
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.
VSS_E_UNEXPECTED	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

IVssBackupComponents::P reRestore

IVssComponent::IsSelectedForRestore

VSS_COMPONENT_TYPE