VSS_BACKUP_SCHEMA enumeração (vss.h)

Artigo
08/27/2023

A enumeração VSS_BACKUP_SCHEMA é usada por um gravador para indicar os tipos de operações de backup em que ele pode participar. Os tipos de backup com suporte são expressos como uma máscara de bits (ou OR bit a bit) de valores de VSS_BACKUP_SCHEMA .

Syntax

typedef enum _VSS_BACKUP_SCHEMA {
  VSS_BS_UNDEFINED = 0,
  VSS_BS_DIFFERENTIAL = 0x1,
  VSS_BS_INCREMENTAL = 0x2,
  VSS_BS_EXCLUSIVE_INCREMENTAL_DIFFERENTIAL = 0x4,
  VSS_BS_LOG = 0x8,
  VSS_BS_COPY = 0x10,
  VSS_BS_TIMESTAMPED = 0x20,
  VSS_BS_LAST_MODIFY = 0x40,
  VSS_BS_LSN = 0x80,
  VSS_BS_WRITER_SUPPORTS_NEW_TARGET = 0x100,
  VSS_BS_WRITER_SUPPORTS_RESTORE_WITH_MOVE = 0x200,
  VSS_BS_INDEPENDENT_SYSTEM_STATE = 0x400,
  VSS_BS_ROLLFORWARD_RESTORE = 0x1000,
  VSS_BS_RESTORE_RENAME = 0x2000,
  VSS_BS_AUTHORITATIVE_RESTORE = 0x4000,
  VSS_BS_WRITER_SUPPORTS_PARALLEL_RESTORES = 0x8000
} VSS_BACKUP_SCHEMA, *PVSS_BACKUP_SCHEMA;

Constantes


`VSS_BS_UNDEFINED` Valor: 0 O gravador dá suporte a um backup completo simples e à restauração de arquivos inteiros (conforme definido por um VSS_BACKUP_TYPE valor de VSS_BT_FULL). Esse esquema de backup pode ser usado como base de um incremental ou backup diferencial. Esse é o valor padrão.
`VSS_BS_DIFFERENTIAL` Valor: 0x1 O gravador dá suporte a backups diferenciais (correspondentes ao VSS_BACKUP_TYPE valor VSS_BT_DIFFERENTIAL). Arquivos criados ou alterados desde o último backup completo são salvos. Os arquivos não são marcados como tendo sido copiados em backup. Essa configuração não impede a combinação de backups incrementais e diferenciais. Não há suporte para esse valor para gravadores expressos.
`VSS_BS_INCREMENTAL` Valor: 0x2 O gravador dá suporte a backups incrementais (correspondentes ao VSS_BACKUP_TYPE valor VSS_BT_INCREMENTAL). Arquivos criados ou alterados desde o último completo ou incremental backup são salvos. Os arquivos são marcados como tendo sido copiados em backup. Essa configuração não impede a combinação de backups incrementais e diferenciais. Não há suporte para esse valor para gravadores expressos.
`VSS_BS_EXCLUSIVE_INCREMENTAL_DIFFERENTIAL` Valor: 0x4 O gravador dá suporte a esquemas de backup diferenciais e incrementais, mas somente exclusivamente: por exemplo, você não pode seguir um backup diferencial com um incremental. Um gravador não poderá dar suporte a esse esquema se ele o fizer não dá suporte a esquemas incrementais e diferenciais (VSS_BS_DIFFERENTIAL	VSS_BS_INCREMENTAL). Não há suporte para esse valor para gravadores expressos.
`VSS_BS_LOG` Valor: 0x8 O gravador dá suporte a backups que envolvem apenas os arquivos de log que ele gerencia (correspondente a um VSS_BACKUP_TYPE valor de VSS_BT_LOG). Esse esquema exige que um gravador tenha adicionado pelo menos um arquivo a em pelo menos um componente usando o IVssCreateWriterMetadata::AddDataBaseLogFiles método. Os solicitantes recuperam informações de arquivo de log usando o IVssWMComponent::GetDatabaseLogFile método.
`VSS_BS_COPY` Valor: 0x10 Semelhante ao esquema de backup padrão (VSS_BT_UNDEFINED), o gravador dá suporte copiar operações de backup (correspondentes a VSS_BT_COPY) em que as informações de acesso a arquivos (como informações de quando um arquivo foi feito o último backup) não serão atualizadas no próprio estado do gravador informações ou nas informações do sistema de arquivos. Esse tipo de backup não pode ser usado como base de um incremental ou backup diferencial.
`VSS_BS_TIMESTAMPED` Valor: 0x20 Um gravador dá suporte ao uso do mecanismo de carimbo de data/hora do VSS ao avaliar se um arquivo deve ser incluído no operações diferenciais ou incrementais (correspondentes a VSS_BT_DIFFERENTIAL e VSS_BT_INCREMENTAL, respectivamente) usando o IVssComponent::GetBackupStamp, IVssComponent::GetPreviousBackupStamp, IVssComponent::SetBackupStamp e IVssBackupComponents::SetPreviousBackupStamp Métodos. Um gravador não poderá dar suporte a esse esquema se ele não oferecer suporte a esquemas de backup diferenciais ou incrementais (VSS_BS_DIFFERENTIAL ou VSS_BS_INCREMENTAL). Não há suporte para esse valor para gravadores expressos.
`VSS_BS_LAST_MODIFY` Valor: 0x40 Ao implementar backups incrementais ou diferenciais com arquivos diferenciados, um gravador pode fornecer por último informações de tempo de modificação para arquivos (usando IVssComponent::AddDifferencedFilesByLastModifyTime). Em seguida, um solicitante pode usar IVssComponent::GetDifferencedFile para obter arquivos candidatos e informações sobre seus últimos dados de modificação. O solicitante pode usar isso informações (juntamente com quaisquer registros sobre operações de backup anteriores que ele mantém) para decidir se um arquivo deve ser incluído em backups incrementais e diferenciais. Esse esquema não se aplica a implementações parciais de arquivos de backup incremental e diferencial . Um gravador não poderá dar suporte a esse esquema se ele não oferecer suporte a esquemas de backup incrementais ou diferenciais (VSS_BS_DIFFERENTIAL ou VSS_BS_INCREMENTAL). Não há suporte para esse valor para gravadores expressos.
`VSS_BS_LSN` Valor: 0x80 Reservado para uso do sistema.
`VSS_BS_WRITER_SUPPORTS_NEW_TARGET` Valor: 0x100 O gravador dá suporte a um solicitante que altera o destino para restauração de arquivo usando IVssBackupComponents::AddNewTarget. (Consulte Backup e restauração não padrão Locais para obter mais informações.) Não há suporte para esse valor para gravadores expressos.
`VSS_BS_WRITER_SUPPORTS_RESTORE_WITH_MOVE` Valor: 0x200 O gravador dá suporte à execução de várias instâncias de gravador com a mesma ID de classe e dá suporte a um solicitante movendo um componente para uma instância de gravador diferente no momento da restauração usando IVssBackupComponentsEx::SetSelectedForRestoreEx. Não há suporte para esse valor para gravadores expressos. Windows Server 2003: Esse valor não tem suporte até o Windows Server 2003 com SP1.
`VSS_BS_INDEPENDENT_SYSTEM_STATE` Valor: 0x400 O gravador dá suporte ao backup de dados que fazem parte do estado do sistema, mas que também podem ser copiados em backup independentemente do estado do sistema. Windows Server 2003: Esse valor não tem suporte até o Windows Vista.
`VSS_BS_ROLLFORWARD_RESTORE` Valor: 0x1000 O gravador dá suporte a um solicitante definindo um ponto de restauração roll forward usando IVssBackupComponentsEx2::SetRollForward. Não há suporte para esse valor para gravadores expressos. Windows Server 2003: Esse valor não tem suporte até o Windows Vista.
`VSS_BS_RESTORE_RENAME` Valor: 0x2000 O gravador dá suporte a um solicitante definindo um nome de restauração usando IVssBackupComponentsEx2::SetRestoreName. Não há suporte para esse valor para gravadores expressos. Windows Server 2003: Esse valor não tem suporte até o Windows Vista.
`VSS_BS_AUTHORITATIVE_RESTORE` Valor: 0x4000 O gravador dá suporte a uma restauração autoritativa de configuração do solicitante usando IVssBackupComponentsEx2::SetAuthoritativeRestore. Não há suporte para esse valor para gravadores expressos. Windows Server 2003: Esse valor não tem suporte até o Windows Vista.
`VSS_BS_WRITER_SUPPORTS_PARALLEL_RESTORES` Valor: 0x8000 O gravador dá suporte a vários eventos de restauração não sincronizados. Não há suporte para esse valor para gravadores expressos. Windows Vista e Windows Server 2003: Esse valor não tem suporte até o Windows Server 2008.

Comentários

O gravador define seus esquemas de backup com chamadas para IVssCreateWriterMetadata::SetBackupSchema.

Os solicitantes usam IVssExamineWriterMetadata::GetBackupSchema para determinar o esquema de backup compatível com um gravador.

Para que um tipo específico de operação de backup tenha suporte, o gravador deve dar suporte ao esquema correspondente e o solicitante deve definir o tipo de backup correspondente.

Por exemplo, para envolver um gravador em uma operação de backup incremental, o solicitante deve definir o tipo de backup como VSS_BT_INCREMENTAL e o gravador deve ter um esquema de backup que inclua VSS_BS_INCREMENTAL.

Um gravador que não dá suporte ao esquema de backup correspondente ao tipo de backup de um solicitante deve tratar a operação de backup que está sendo executada como se fosse um backup padrão (completo). Se o tipo de backup desejado não tiver suporte no esquema de backup do gravador, o solicitante poderá executar um backup completo para esse gravador ou excluir o gravador da operação de backup. Um solicitante pode excluir um gravador selecionando nenhum dos componentes do gravador (consulte Trabalhando com selebilidade e caminhos lógicos) ou desabilitando o gravador (consulte IVssBackupComponents::D isableWriterClasses ou IVssBackupComponents::D isableWriterInstances).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	vss.h