Trabalhando com a selebilidade para restauração e subcomponentes

A selebilidade 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 Backup Components. 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 Backup Components; 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 selebilidade para restauração. O solicitante chama IVssBackupComponents::SetSelectedForRestore, passando a 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 só poderão ser selecionados individualmente para restauração se forem marcados como selecionáveis para restauração. O solicitante primeiro chama IVssBackupComponents::SetSelectedForRestore no componente ancestral incluído explicitamente mais próximo e, em seguida, chama IVssBackupComponents::AddRestoreSubcomponent no componente ancestral para selecionar o componente implicitamente incluído para restauração. Depois que isso for feito, somente o componente selecionado implicitamente será restaurado; todos os outros componentes no conjunto de componentes não serão restaurados.

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

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