Conteúdo do documento de componentes de backup

O documento de componentes de backup é mantido por instâncias do IVssBackupComponents interface. Essa interface também contém vários métodos para controlar operações de backup, manipular cópias de sombra e consultar o estado do sistema. No entanto, nem todas as informações do documento são diretamente acessíveis através desta interface.

O documento de componentes de backup consiste em vários conjuntos de dados:

• Informações sobre quais componentes foram explicitamente incluídos em uma operação de backup ou restauração
• Uma representação do componente armazenado e informações do gravador
• Informações de estado sobre a operação de backup/recuperação

Embora as informações do componente estejam disponíveis para o solicitante e o gravador, somente o gravador tem acesso às informações de estado.

Informações de inclusão de componentes

O documento de componentes de backup contém uma lista desses componentes explicitamente incluídos no backup e restauração pelo solicitante. A lista contém o seguinte:

• Explicitamente incluídos componentes selecionáveis.

  A inclusão desses arquivos em operações de backup é indicada por IVssBackupComponents::AddComponent e em operações de restauração por IVssBackupComponents::SetSelectedForRestore.

• Não selecionável para subcomponentes de backup sem um ancestral selecionável para componentes de backup.

  Todos esses componentes devem ser incluídos se algum componente do gravador deve ser incluído na operação. A inclusão desses arquivos em operações de backup é indicada por IVssBackupComponents::AddComponent e em operações de restauração por IVssBackupComponents::SetSelectedForRestore.

• Componentes adicionados implicitamente ao backup (subcomponentes) que são selecionáveis para restauração e são explicitamente adicionados à restauração.

  Esses componentes podem ser selecionáveis ou não selecionáveis, mas têm um ancestral selecionável que foi usado para selecioná-los implicitamente para backup. Eles são adicionados ao documento de componentes de backup por IVssBackupComponents::AddRestoreSubcomponent.

As identidades dos componentes incluídos implicitamente na restauração não são armazenadas no documento de componentes de backup.

O VSS tem acesso a informações sobre inclusão de componentes: gravadores sem componentes explicitamente incluídos em uma restauração ou backup não recebem eventos VSS após a geração doPrepareForBackup ou eventos de PreRestore.

Os autores não podem consultar diretamente essas informações. Esta não é uma limitação significativa porque, por design, os gravadores VSS individuais não devem exigir informações detalhadas sobre o status de outros gravadores no sistema e, como observado acima, aqueles sem componentes incluídos não terão que participar da operação VSS.

Um solicitante pode determinar quais componentes foram explicitamente incluídos em uma operação.

O método IVssBackupComponents::GetWriterComponentsCount retorna o número de gravadores com informações de componentes armazenadas no documento de componentes de backup (e não o número de componentes no documento).

O solicitante indexa através das informações armazenadas do gravador usando IVssBackupComponents::GetWriterComponents, que retorna instâncias da interfaceIVssWriterComponentsExt. A interface IVssWriterComponentsExt permite que o solicitante obtenha a classe de gravador e de instância do gravador dos gravadores participantes, bem como acesse informações sobre os de seus componentes armazenados no documento de componentes de backup.

Informações sobre componentes incluídos

A representação do documento de componentes de backup dos dados do componente (que não inclui informações de especificação de caminho e arquivo), que é acessada por meio de instâncias da interfaceIVssComponent.

Solicitantes e gravadores obtêm acesso a instâncias da interfaceIVssComponentde maneiras diferentes.

Um solicitante examina os dados do componente em uma base de gravador por gravador usando instâncias do IVssWriterComponentsExt interface retornada pelo IVssBackupComponents::GetWriterComponents.

Além das informações de identificação do gravador, a interfaceIVssWriterComponentsExt fornece uma matriz de instâncias da interfaceIVssComponent— uma para cada um dos componentes incluídos nos gravadores selecionados.

Conforme observado no de Ciclo de Vida do DocumentoComponentes de Backup, os gravadores podem obter acesso às mesmas informações por meio da interfaceIVssWriterComponentsao manipular o evento PrepareForBackup, PrepareForSnapshot, PostSnapshot, BackupComplete, PreRestore ou PostRestore.

IVssComponent permite que o gravador e os solicitantes obtenham as seguintes informações:

• O nome, o tipo e caminho lógico de um componente (GetComponentName, GetComponentType, GetLogicalPath)
• Como um componente deve ser restaurado conforme indicado pelode destino de restauração(IVssComponent::GetRestoreTarget)
• Se um local alternativo foi usado na restauração de um arquivo (GetAlternateLocationMapping, GetAlternateLocationMappingCount)
• Novas informações de destino, se houver (GetNewTarget, GetNewTargetCount)
• Mensagens de erro pré e pós-restauração (GetPreRestoreFailureMsg, GetPostRestoreFailureMsg)
• Se um selecionável para backup componente que define um conjunto de componentes tiver sido selecionado para restauração (IsSelectedForRestore)
• Se um backup ou restauração foi bem-sucedido (GetBackupSucceeded, GetFileRestoreStatus)
• Qualquer opção de backup ou restauração específica do gravador que possa ter sido definida pelo IVssBackupComponents::SetBackupOptions ou IVssBackupComponents::SetRestoreOptions (GetBackupOptions, GetRestoreOptions)
• Qualquer backup ou restauração de metadados específicos do gravador (GetBackupMetadata), GetRestoreMetadata)
• Informações de carimbo de data/hora (GetBackupStamp, GetPreviousBackupStamp)
• Informações sobre subcomponentes de backup explicitamente incluídos em uma restauração (GetRestoreSubcomponent, GetRestoreSubcomponentCount)

Ao contrário dos solicitantes, os gravadores podem alterar determinadas informações no documento de componentes de backup por meio da interface IVssComponent:

• Como um componente deve ser restaurado conforme indicado pelo destino de restauração (IVssComponent::SetRestoreTarget)
• Metadados de backup e restauração específicos do gravador (IVssComponent::SetBackupMetadata, IVssComponent::SetRestoreMetadata)
• Informações de carimbo de data/hora (SetBackupStamp)
• Mensagens de erro pré e pós-restauração (SetPreRestoreFailureMsg, SetPostRestoreFailureMsg)

Informações sobre o Estado do Requerente

Os solicitantes inserem informações sobre o estado de uma operação de backup ou restauração no documento de componentes de backup usando a interfaceIVssBackupComponents. Os aplicativos Writer são capazes de consultar essas informações através da classeCVssWriter.

As informações de estado armazenadas no documento de componentes de backup incluem o seguinte:

Informações gerais sobre o backup

• O tipo geral de backup (incremental, diferencial ou completo)

Definido por solicitantes usando IVssBackupComponents::SetBackupState

Definido por solicitantes usando IVssBackupComponents::SetBackupState

Recuperado por escritores usando CVssWriter::AreComponentsSelected

Definido por solicitantes usando IVssBackupComponents::SetBackupState

Recuperado por escritores usando CVssWriter::IsBootableStateBackedUp

Definido por solicitantes usando IVssBackupComponents::SetBackupState

Recuperado por escritores usando CVssWriter::IsPartialFileSupportEnabled

Informações gerais sobre a restauração

• O tipo de restauração geral (se a restauração é por cópia ou importação)

Definido por solicitantes usando IVssBackupComponents::SetRestoreState

Informações sobre arquivos de suporte

• O local dos arquivos de intervalos usados por um componente específico em operações de arquivo parcial

Definido por solicitantes usando IVssBackupComponents::SetRangesFilePath

Estado da Informação

• Indique se o backup de um determinado componente do gravador foi feito com êxito

Definido por solicitantes usando IVssBackupComponents::SetBackupSucceeded

Definido por solicitantes usando IVssBackupComponents::SetFileRestoreStatus

Recuperado por gravadores e solicitantes usando IVssComponent::GetFileRestoreStatus

Informação Writer-Settable

• Especificação de backup adicional para um dos componentes de um determinado gravador

Definido por gravadores usando IVssComponent::SetBackupMetadata

Definido por gravadores usando IVssComponent::SetRestoreMetadata

Recuperado por escritores e solicitantes usando IVssComponent::GetRestoreMetadata

Definido por gravadores usando IVssComponent::SetBackupStamp

Recuperado por escritores e solicitantes usando IVssComponent::GetBackupStamp

Armazenado e definido por solicitantes para um componente específico usando IVssBackupComponents::SetPreviousBackupStamp

Recuperado por escritores e solicitantes usando IVssComponent::GetPreviousBackupStamp

Definido por gravadores usando IVssComponent::SetPreRestoreFailureMsg ou IVssComponent::SetPostRestoreFailureMsg

Recuperado por gravadores e solicitantes usando IVssComponent::GetPreRestoreFailureMsg ou IVssComponent::GetPostRestoreFailureMsg