VSS_VOLUME_SNAPSHOT_ATTRIBUTES enumeración (vss.h)

Artículo
08/27/2023

Permite especificar atributos adicionales para una instantánea. El contexto de una instantánea (según lo establecido por el método IVssBackupComponents::SetContext ) se puede modificar mediante una máscara de bits que contiene una combinación válida de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES y _VSS_SNAPSHOT_CONTEXT valores de enumeración.

Syntax

typedef enum _VSS_VOLUME_SNAPSHOT_ATTRIBUTES {
  VSS_VOLSNAP_ATTR_PERSISTENT = 0x1,
  VSS_VOLSNAP_ATTR_NO_AUTORECOVERY = 0x2,
  VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE = 0x4,
  VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE = 0x8,
  VSS_VOLSNAP_ATTR_NO_WRITERS = 0x10,
  VSS_VOLSNAP_ATTR_TRANSPORTABLE = 0x20,
  VSS_VOLSNAP_ATTR_NOT_SURFACED = 0x40,
  VSS_VOLSNAP_ATTR_NOT_TRANSACTED = 0x80,
  VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED = 0x10000,
  VSS_VOLSNAP_ATTR_DIFFERENTIAL = 0x20000,
  VSS_VOLSNAP_ATTR_PLEX = 0x40000,
  VSS_VOLSNAP_ATTR_IMPORTED = 0x80000,
  VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY = 0x100000,
  VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY = 0x200000,
  VSS_VOLSNAP_ATTR_AUTORECOVER = 0x400000,
  VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY = 0x800000,
  VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT = 0x1000000,
  VSS_VOLSNAP_ATTR_TXF_RECOVERY = 0x2000000,
  VSS_VOLSNAP_ATTR_FILE_SHARE = 0x4000000
} VSS_VOLUME_SNAPSHOT_ATTRIBUTES, *PVSS_VOLUME_SNAPSHOT_ATTRIBUTES;

Constantes


`VSS_VOLSNAP_ATTR_PERSISTENT` Valor: 0x1 La instantánea es persistente en los reinicios. Este atributo se establece automáticamente para _VSS_SNAPSHOT_CONTEXT contextos de VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS y VSS_CTX_NAS_ROLLBACK. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_NO_AUTORECOVERY` Valor: 0x2 La recuperación automática está deshabilitada para la instantánea. Un solicitante puede modificar un contexto de instantánea con un OR bit a bit de este atributo. Al hacerlo, el solicitante indica a VSS que haga que la instantánea sea de solo lectura inmediatamente después de crearla, sin permitir que escritores u otras aplicaciones actualicen los componentes en la instantánea. Deshabilitar la recuperación automática puede hacer que la instantánea esté en un estado incoherente si alguno de sus componentes participa en las operaciones de base de datos transaccionales, como las operaciones de lectura y escritura transaccionales administradas por NTFS transaccional (TxF). Esto se debe a que deshabilitar la recuperación automática impide que las transacciones incompletas se revierten. Deshabilitar la recuperación automática también impide que los escritores excluyan los archivos de la instantánea. Cuando se deshabilita la recuperación automática, un escritor todavía puede llamar al método IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot , pero el método CVssWriter::OnPostSnapshot del escritor no puede eliminar los archivos de la instantánea. Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Vista.
`VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE` Valor: 0x4 La instantánea especificada es una instantánea accesible para el cliente que admite instantáneas para carpetas compartidas y no debe exponerse. Este atributo se establece automáticamente para VSS_CTX_CLIENT_ACCESSIBLE y VSS_CTX_CLIENT_ACCESSIBLE_WRITERS. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE` Valor: 0x8 La instantánea no se elimina automáticamente cuando finaliza el proceso del solicitante de instantáneas. La instantánea solo se puede eliminar mediante una llamada a IVssBackupComponents::D eleteSnapshots. Este atributo se establece automáticamente para _VSS_SNAPSHOT_CONTEXT contextos de VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS y VSS_CTX_NAS_ROLLBACK. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_NO_WRITERS` Valor: 0x10 No hay escritores implicados en la creación de la instantánea. Este atributo se establece automáticamente para _VSS_SNAPSHOT_CONTEXT contextos de VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP y VSS_CTX_CLIENT_ACCESSIBLE. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_TRANSPORTABLE` Valor: 0x20 La instantánea debe transportarse y, por lo tanto, no debe aparecer localmente. Los solicitantes pueden usar este atributo explícitamente al establecer el contexto de una instantánea, si el proveedor de instantáneas admite instantáneas transportables. Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition y Windows XP: Este atributo no se admite. Todas las ediciones de Windows Server 2003 con SP1 admiten este atributo. Consulte Importación de transportable Volúmenes de instantáneas para obtener más información.
`VSS_VOLSNAP_ATTR_NOT_SURFACED` Valor: 0x40 La instantánea no está expuesta actualmente. A menos que la instantánea se exponga o monte explícitamente, este atributo se establece para todas las instantáneas. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_NOT_TRANSACTED` Valor: 0x80 La instantánea no se realiza con transacciones. Un solicitante puede modificar un contexto de instantánea con un OR bit a bit de este atributo. Al hacerlo, el solicitante indica a VSS que deshabilite la integración integrada entre VSS y los administradores de transacciones y recursos. Establecer este atributo garantiza que el solicitante no recibirá errores VSS_E_TRANSACTION_FREEZE_TIMEOUT. Sin embargo, puede causar consecuencias no deseadas, como la pérdida de integridad transaccional o incluso la pérdida de datos. Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Vista.
`VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED` Valor: 0x10000 Indica que un proveedor determinado es un proveedor de hardware. Este atributo se establece automáticamente para los proveedores de hardware. Este valor de enumeración no se puede usar para establecer manualmente el contexto (mediante . IVssBackupComponents::SetContext method) de una instantánea mediante una máscara de bits (o OR bit a bit) de este valor de enumeración y una instantánea válida valor de contexto de _VSS_SNAPSHOT_CONTEXT.
`VSS_VOLSNAP_ATTR_DIFFERENTIAL` Valor: 0x20000 Indica que un proveedor determinado usa datos diferenciales o un mecanismo de copia en escritura para implementar instantáneas. Un solicitante puede modificar un contexto de instantánea con un OR bit a bit de este atributo. Al hacer esto, el requester indica a los proveedores que creen una instantánea mediante una implementación diferencial. Si no hay instantánea proveedor instalado en el sistema admite los atributos solicitados, se producirá un error de VSS_E_VOLUME_NOT_SUPPORTED devuelto a IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_PLEX` Valor: 0x40000 Indica que un proveedor determinado usa un mecanismo de división PLEX o reflejado para implementar instantáneas. Un solicitante puede modificar un contexto de instantánea con un OR bit a bit de este atributo. Al hacer esto, el Requester indica a los proveedores que creen una instantánea mediante una implementación de PLEX. Si no hay instantánea proveedor instalado en el sistema admite los atributos solicitados, se producirá un error de VSS_E_VOLUME_NOT_SUPPORTED devuelto a IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_IMPORTED` Valor: 0x80000 La instantánea del volumen se importó en esta máquina mediante IVssBackupComponents::ImportSnapshots método en lugar de creado mediante IVssBackupComponents::D oSnapshotSet . Este atributo se establece automáticamente si se importa una instantánea. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY` Valor: 0x100000 La instantánea se expone localmente. Si esta marca de bits y la marca de bits de VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY son no establecido, la instantánea está oculta. El atributo se agrega automáticamente a un contexto de instantánea al llamar al IVssBackupComponents::ExposeSnapshot para exponer una instantánea localmente. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY` Valor: 0x200000 La instantánea se expone de forma remota. Si esta marca de bits y la marca de bits de VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY son no establecido, la instantánea está oculta. El atributo se agrega automáticamente a un contexto de instantánea al llamar al IVssBackupComponents::ExposeSnapshot para exponer una instantánea localmente. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_AUTORECOVER` Valor: 0x400000 Indica que el escritor tendrá que recuperar automáticamente el componente en CSVSWriter::OnPostSnapshot. Los solicitantes no deben usar este atributo explícitamente al establecer el contexto de una instantánea.
`VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY` Valor: 0x800000 Indica que el escritor tendrá que recuperar automáticamente el componente en CSVSWriter::OnPostSnapshot si la instantánea se usa para la reversión (por ejemplo, para la minería de datos). Un solicitante establecería esta marca en el contexto de instantáneas para indicar que la instantánea se está creando para un propósito que no sea de copia de seguridad, como la minería de datos.
`VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT` Valor: 0x1000000 Reservado para uso del sistema. Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008.
`VSS_VOLSNAP_ATTR_TXF_RECOVERY` Valor: 0x2000000 Indica que se debe aplicar la recuperación de TxF durante la creación de instantáneas. Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008.
`VSS_VOLSNAP_ATTR_FILE_SHARE` Valor: 0x4000000

Comentarios

El contexto predeterminado para las instantáneas de VSS es VSS_CTX_BACKUP.

Un solicitante establece el contexto de una instantánea a punto de crearse pasando el miembro de la enumeración _VSS_SNAPSHOT_CONTEXT al método IVssBackupComponents::SetContext .

Los solicitantes pueden modificar este contexto mediante un or bit a bit del valor de _VSS_SNAPSHOT_CONTEXT con un valor admitido de la enumeración _VSS_VOLUME_SNAPSHOT_ATTRIBUTES como argumento para IVssBackupComponents::SetContext.

A menos que se solicite específicamente que admita un mecanismo determinado, los proveedores pueden usar cualquier tipo de mecanismo para implementar una instantánea. Por lo tanto, en el caso de que no se especifique un método de instantánea, el proveedor puede elegir un mecanismo diferencial (VSS_VOLSNAP_ATTR_DIFFERENTIAL), un mecanismo PLEX (VSS_VOLSNAP_ATTR_PLEX) o cualquier otro mecanismo para admitir la instantánea.

Aunque un proveedor puede admitir ambos mecanismos, son mutuamente excluyentes para una instantánea determinada. Los solicitantes no deben usar tanto VSS_VOLSNAP_ATTR_DIFFERENTIAL comoVSS_VOLSNAP_ATTR_PLEX para modificar un contexto de instantánea específico.

Actualmente, VSS_VOLSNAP_ATTR_DIFFERENTIAL, VSS_VOLSNAP_ATTR_PLEX y VSS_VOLSNAP_ATTR_TRANSPORTABLE son los únicos valores de la enumeración _VSS_VOLUME_SNAPSHOT_ATTRIBUTES que se pueden usar para modificar cualquier contexto.

Además, no se puede usar para modificar un contexto de VSS_CTX_CLIENT_ACCESSIBLE .

Un solicitante puede obtener información sobre una instantánea específica (identificada por VSS_ID) desempaquetando la estructura VSS_SNAPSHOT_PROP de la estructura de VSS_OBJECT_PROP devuelta por una llamada a IVssBackupComponents::GetSnapshotProperties.

Un solicitante también puede obtener una estructura de VSS_SNAPSHOT_PROP para cada una de varias instantáneas llamando a IVssBackupComponents::Query y usando IVssEnumObject para iterar los resultados.

El contexto y los atributos de las instantáneas se encuentran como máscara de bits contenida en el miembro m_lSnapshotAttributes de la estructura VSS_SNAPSHOT_PROP .

Requisitos


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