VSS_FILE_SPEC_BACKUP_TYPE enumeração (vss.h)

Artigo
08/27/2023

A enumeração VSS_FILE_SPEC_BACKUP_TYPE é usada por gravadores para indicar seu suporte a determinadas operações de backup, como backup incremental ou diferencial, com base em conjuntos de arquivos (um arquivo ou arquivos especificado).

Os conjuntos de arquivos armazenados no Documento de Metadados do Gravador são marcados com uma máscara de bits (ou OR bit a bit) de valores VSS_FILE_SPEC_BACKUP_TYPE indicando o seguinte:

Se o gravador e o solicitante precisam avaliar um determinado conjunto de arquivos para participação no tipo especificado de operações de backup
Se o backup do arquivo especificado exigirá uma cópia de sombra

Syntax

typedef enum _VSS_FILE_SPEC_BACKUP_TYPE {
  VSS_FSBT_FULL_BACKUP_REQUIRED = 0x1,
  VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED = 0x2,
  VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED = 0x4,
  VSS_FSBT_LOG_BACKUP_REQUIRED = 0x8,
  VSS_FSBT_FULL_SNAPSHOT_REQUIRED = 0x100,
  VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED = 0x200,
  VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED = 0x400,
  VSS_FSBT_LOG_SNAPSHOT_REQUIRED = 0x800,
  VSS_FSBT_CREATED_DURING_BACKUP = 0x10000,
  VSS_FSBT_ALL_BACKUP_REQUIRED = 0xf,
  VSS_FSBT_ALL_SNAPSHOT_REQUIRED = 0xf00
} VSS_FILE_SPEC_BACKUP_TYPE, *PVSS_FILE_SPEC_BACKUP_TYPE;

Constantes


`VSS_FSBT_FULL_BACKUP_REQUIRED` Valor: 0x1 Um conjunto de arquivos marcado com esse valor deve estar envolvido em todos os tipos de operações de backup. Um gravador marca um conjunto de arquivos com esse valor para indicar ao solicitante que ele espera uma cópia do atual versão do conjunto de arquivos a estar disponível após a restauração de qualquer operação de backup com um VSS_BACKUP_TYPE de VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` Valor: 0x2 Um gravador marca um conjunto de arquivos com esse valor para indicar ao solicitante que ele espera uma cópia do atual versão do conjunto de arquivos a estar disponível após a restauração de qualquer operação de backup com um VSS_BACKUP_TYPE de VSS_BT_DIFFERENTIAL. Não há suporte para esse valor para gravadores expressos.
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` Valor: 0x4 Um gravador marca um conjunto de arquivos com esse valor para indicar ao solicitante que ele espera uma cópia do atual versão do conjunto de arquivos a estar disponível após a restauração de qualquer operação de backup com um VSS_BACKUP_TYPE de VSS_BT_INCREMENTAL. Não há suporte para esse valor para gravadores expressos.
`VSS_FSBT_LOG_BACKUP_REQUIRED` Valor: 0x8 Um gravador marca um conjunto de arquivos com esse valor para indicar ao solicitante que ele espera uma cópia do atual versão do conjunto de arquivos a estar disponível após a restauração de qualquer operação de backup com um VSS_BACKUP_TYPE de VSS_BT_LOG. Não há suporte para esse valor para gravadores expressos.
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` Valor: 0x100 Um conjunto de arquivos marcado com esse valor deve ser copiado de uma cópia de sombra de um volume (e nunca do volume original) ao participar de uma operação de backup com um VSS_BACKUP_TYPE de VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` Valor: 0x200 Um conjunto de arquivos marcado com esse valor deve ser copiado de uma cópia de sombra de um volume (e nunca do volume original) ao participar de uma operação de backup com um VSS_BACKUP_TYPE de VSS_BT_DIFFERENTIAL.
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` Valor: 0x400 Um conjunto de arquivos marcado com esse valor deve ser copiado de uma cópia de sombra de um volume (e nunca do volume original) ao participar de uma operação de backup com um VSS_BACKUP_TYPE de VSS_BT_INCREMENTAL.
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` Valor: 0x800 Um conjunto de arquivos marcado com esse valor deve ser copiado de uma cópia de sombra de um volume (e nunca do volume original) ao participar de uma operação de backup com um VSS_BACKUP_TYPE de VSS_BT_LOG).
`VSS_FSBT_CREATED_DURING_BACKUP` Valor: 0x10000 Um gravador marca um conjunto de arquivos com esse valor para indicar ao solicitante que ele espera que o arquivo seja criado durante a sequência de instantâneo.
`VSS_FSBT_ALL_BACKUP_REQUIRED` Valor: 0xf O tipo de especificação de backup de arquivo padrão. Um conjunto de arquivos marcado com esse valor sempre deve participar operações de backup e restauração.
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` Valor: 0xf00 O requisito de cópia de sombra para backup. Um conjunto de arquivos marcado com esse valor sempre deve ser copiado em backup de um cópia de sombra de um volume (e nunca do volume original) ao participar de uma operação de backup.

Comentários

Quando um gravador define um valor necessário de backup da enumeração VSS_FILE_SPEC_BACKUP_TYPE , ele indica que o solicitante executa o backup de forma que, quando o backup for restaurado, a versão atual do conjunto de arquivos seja restaurada. Normalmente, isso significa que o conjunto de arquivos é copiado como parte do backup.

Essa configuração poderá ser substituída se um arquivo for adicionado ao Documento de Componentes de Backup como um arquivo diferente (usando IVssComponent::AddDifferencedFilesByLastModifyTime) ou como um arquivo parcial (usando IVssComponent::AddPartialFile).

Se um arquivo for adicionado como um arquivo diferente, o gravador estabelecerá critérios pelos quais o solicitante deve decidir se deve ou não copiar um arquivo para um meio de backup. Um gravador normalmente adiciona arquivos diferentes ao Documento de Componentes de Backup para inclusão em um evento postSnapshot de backup (consulte CVssWriter::OnPostSnapshot). Confira Backups incrementais e diferenciais para obter detalhes.

Quando um gravador define um valor necessário de cópia de sombra da enumeração VSS_FILE_SPEC_BACKUP_TYPE , ele indica que o conjunto de arquivos deve ser copiado em backup de um volume copiado por sombra. Os conjuntos de arquivos não marcados com um valor necessário para cópia de sombra podem ser copiados do volume original.

Os gravadores definem VSS_FILE_SPEC_BACKUP_TYPE valores ao manipular um evento identificá-lo (consulte CVssWriter::OnIdentify).

Uma máscara de bits (ou OR bit a bit) de valores VSS_FILE_SPEC_BACKUP_TYPE pode ser aplicada a um conjunto de arquivos ao adicioná-lo a um componente usando o método IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles ou IVssCreateWriterMetadata::AddDatabaseLogFiles .

Se nenhum tipo de backup de especificação de arquivo explícito for fornecido durante a adição de uma especificação de arquivo a um componente, a especificação será marcada com o valor de VSS_FILE_SPEC_BACKUP_TYPE padrão: (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Solicitantes ou gravadores podem recuperar o tipo de backup de especificação de arquivo de um conjunto de arquivos usando o método IVssWMFiledesc::GetBackupTypeMask .

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