VSS_FILE_SPEC_BACKUP_TYPE enumeración (vss.h)

Artículo
08/27/2023

Los escritores usan la enumeración VSS_FILE_SPEC_BACKUP_TYPE para indicar su compatibilidad con determinadas operaciones de copia de seguridad( como la copia de seguridad incremental o diferencial) en función de los conjuntos de archivos (un archivo o archivos especificados).

Los conjuntos de archivos almacenados en el documento de metadatos del escritor se etiquetan con una máscara de bits (o OR bit a bit) de VSS_FILE_SPEC_BACKUP_TYPE valores que indican lo siguiente:

Si el escritor y el solicitante tienen que evaluar un conjunto de archivos determinado para la participación en el tipo especificado de operaciones de copia de seguridad.
Si la copia de seguridad del archivo especificado requerirá una instantánea

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 Un conjunto de archivos etiquetado con este valor debe estar implicado en todos los tipos de operaciones de copia de seguridad. Un escritor etiqueta un conjunto de archivos con este valor para indicar al solicitante que espera una copia del actual. versión del archivo establecido para que esté disponible después de la restauración de cualquier operación de copia de seguridad con VSS_BACKUP_TYPE de VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` Valor: 0x2 Un escritor etiqueta un conjunto de archivos con este valor para indicar al solicitante que espera una copia del actual. versión del archivo establecido para que esté disponible después de la restauración de cualquier operación de copia de seguridad con VSS_BACKUP_TYPE de VSS_BT_DIFFERENTIAL. Este valor no se admite para escritores rápidos.
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` Valor: 0x4 Un escritor etiqueta un conjunto de archivos con este valor para indicar al solicitante que espera una copia del actual. versión del archivo establecido para que esté disponible después de la restauración de cualquier operación de copia de seguridad con VSS_BACKUP_TYPE de VSS_BT_INCREMENTAL. Este valor no se admite para escritores rápidos.
`VSS_FSBT_LOG_BACKUP_REQUIRED` Valor: 0x8 Un escritor etiqueta un conjunto de archivos con este valor para indicar al solicitante que espera una copia del actual. versión del archivo establecido para que esté disponible después de la restauración de cualquier operación de copia de seguridad con VSS_BACKUP_TYPE de VSS_BT_LOG. Este valor no se admite para escritores rápidos.
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` Valor: 0x100 Se debe realizar una copia de seguridad de un conjunto de archivos etiquetado con este valor desde una instantánea de un volumen (y nunca desde el volumen original) al participar en una operación de copia de seguridad con un VSS_BACKUP_TYPE de VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` Valor: 0x200 Se debe realizar una copia de seguridad de un conjunto de archivos etiquetado con este valor desde una instantánea de un volumen (y nunca desde el volumen original) al participar en una operación de copia de seguridad con un VSS_BACKUP_TYPE de VSS_BT_DIFFERENTIAL.
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` Valor: 0x400 Se debe realizar una copia de seguridad de un conjunto de archivos etiquetado con este valor desde una instantánea de un volumen (y nunca desde el volumen original) al participar en una operación de copia de seguridad con un VSS_BACKUP_TYPE de VSS_BT_INCREMENTAL.
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` Valor: 0x800 Se debe realizar una copia de seguridad de un conjunto de archivos etiquetado con este valor desde una instantánea de un volumen (y nunca desde el volumen original) al participar en una operación de copia de seguridad con un VSS_BACKUP_TYPE de VSS_BT_LOG).
`VSS_FSBT_CREATED_DURING_BACKUP` Valor: 0x10000 Un escritor etiqueta un conjunto de archivos con este valor para indicar al solicitante que espera que el archivo se cree durante la secuencia de instantáneas.
`VSS_FSBT_ALL_BACKUP_REQUIRED` Valor: 0xf Tipo de especificación de copia de seguridad de archivos predeterminado. Un conjunto de archivos etiquetado con este valor siempre debe participar en Operaciones de copia de seguridad y restauración.
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` Valor: 0xf00 Requisito de instantáneas para la copia de seguridad. Siempre se debe realizar una copia de seguridad de un conjunto de archivos etiquetado con este valor desde instantánea de un volumen (y nunca del volumen original) al participar en una operación de copia de seguridad.

Comentarios

Cuando un escritor establece un valor obligatorio de copia de seguridad de la enumeración VSS_FILE_SPEC_BACKUP_TYPE , indica que el solicitante realiza la copia de seguridad de tal manera que, cuando se restaura la copia de seguridad, se restaura la versión actual del conjunto de archivos. Normalmente, esto significa que el conjunto de archivos se copia como parte de la copia de seguridad.

Esta configuración se puede invalidar si se agrega un archivo al documento componentes de copia de seguridad como un archivo diferente (mediante IVssComponent::AddDifferencedFilesByLastModifyTime) o como un archivo parcial (mediante IVssComponent::AddPartialFile).

Si se agrega un archivo como un archivo diferente, el escritor establece criterios por los que el solicitante debe decidir si realmente copiar un archivo en un medio de copia de seguridad. Normalmente, un escritor agrega archivos diferenciados al documento componentes de copia de seguridad para su inclusión en un evento PostSnapshot de copia de seguridad (vea CVssWriter::OnPostSnapshot). Consulte Copias de seguridad incrementales y diferenciales para obtener más información.

Cuando un escritor establece un valor necesario para instantáneas de la enumeración VSS_FILE_SPEC_BACKUP_TYPE , indica que se debe realizar una copia de seguridad del conjunto de archivos desde un volumen copiado en sombras. Los conjuntos de archivos no etiquetados con un valor requerido para instantáneas se pueden realizar copias de seguridad desde el volumen original.

Los escritores establecen VSS_FILE_SPEC_BACKUP_TYPE valores al controlar un evento Identify (consulte CVssWriter::OnIdentify).

Se puede aplicar una máscara de bits (o OR bit a bit) de valores de VSS_FILE_SPEC_BACKUP_TYPE a un conjunto de archivos al agregarlo a un componente mediante el método IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles o IVssCreateWriterMetadata::AddDatabaseLogFiles .

Si no se proporciona ningún tipo de copia de seguridad de especificación de archivo explícito durante la adición de una especificación de archivo a un componente, la especificación se etiqueta con el valor de VSS_FILE_SPEC_BACKUP_TYPE predeterminado: (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Los solicitantes o escritores pueden recuperar el tipo de copia de seguridad de especificación de archivo de un conjunto de archivos mediante el método IVssWMFiledesc::GetBackupTypeMask .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	vss.h