Trabalhando com selecionabilidade para restauração e subcomponentes

A seletibilidade para restauração permite que o solicitante determine quando um componente pode ser restaurado individualmente. Um componente que foi incluído para backup pode aparecer de duas maneiras:

• Um componente pode ter sido explicitamente incluído no backup. Esses componentes têm uma instância IVssComponent correspondente no documento de componentes de backup. Esses componentes são incluídos em uma restauração usando IVssBackupComponents::SetSelectedForRestore.
• Um componente pode ter sido incluído implicitamente no backup. Esses componentes não têm uma instância IVssComponent correspondente no Documento de Componentes de Backup; no entanto, sempre haverá uma instância IVssComponent para algum componente ancestral no documento. Esses componentes são incluídos em uma restauração usando IVssBackupComponents::AddRestoreSubcomponent.

Qualquer componente que tenha sido explicitamente incluído no backup sempre pode ser selecionado individualmente para restauração, independentemente de seu valor de seletibilidade para restauração. O solicitante chama IVssBackupComponents::SetSelectedForRestore, passando o ID do gravador, o caminho lógico e o nome do componente específico. Os componentes que foram incluídos implicitamente no backup serão restaurados quando um ancestral explicitamente incluído for restaurado. Os componentes incluídos implicitamente podem ser selecionados individualmente para restauração somente se estiverem marcados como selecionáveis para restauração. O solicitante primeiro chama IVssBackupComponents::SetSelectedForRestore no componente ancestral explicitamente incluído mais próximo e, em seguida, chama IVssBackupComponents::AddRestoreSubcomponent no componente ancestral para selecionar o componente incluído implicitamente para restauração. Depois disso, apenas o componente selecionado implicitamente será restaurado; Todos os outros componentes do conjunto de componentes não serão restaurados.

Ao contrário da seletibilidade para backup, que sempre deve ser definida explicitamente quando um componente é adicionado com IVssCreateWriterMetadata::AddComponent, a seletibilidade para restauração tem um valor padrão de false, que pode ser substituído.

Como os componentes de nível superior (componentes com um caminho lógico vazio) só podem ser explicitamente incluídos em um backup, a seletibilidade para restauração não tem significado para esses componentes.