VSS_VOLUME_SNAPSHOT_ATTRIBUTES enumeração (vss.h)

Artigo
08/27/2023

Permite que atributos adicionais sejam especificados para uma cópia de sombra. O contexto de uma cópia de sombra (conforme definido pelo método IVssBackupComponents::SetContext ) pode ser modificado por uma máscara de bits que contém uma combinação válida de valores de enumeração _VSS_VOLUME_SNAPSHOT_ATTRIBUTES e _VSS_SNAPSHOT_CONTEXT .

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 A cópia de sombra é persistente entre reinicializações. Esse atributo é definido automaticamente para _VSS_SNAPSHOT_CONTEXT contextos de VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS e VSS_CTX_NAS_ROLLBACK. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_NO_AUTORECOVERY` Valor: 0x2 A recuperação automática está desabilitada para a cópia de sombra. Um solicitante pode modificar um contexto de cópia de sombra com um OR bit a bit desse atributo. Ao fazer isso, o solicitante instrui o VSS a tornar a cópia de sombra somente leitura imediatamente após a criação, sem permitir que gravadores ou outros aplicativos atualizem componentes na cópia de sombra. Desabilitar a recuperação automática pode fazer com que a cópia de sombra esteja em um estado inconsistente se algum de seus componentes estiver envolvido em operações de banco de dados transacional, como operações transacionais de leitura e gravação gerenciadas pelo TxFS (Transactional NTFS). Isso ocorre porque desabilitar a recuperação automática impede que transações incompletas sejam revertidas. Desabilitar a recuperação automática também impede que os gravadores excluam arquivos da cópia de sombra. Quando a recuperação automática está desabilitada, um gravador ainda pode chamar o método IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot , mas o método CVssWriter::OnPostSnapshot do gravador não pode excluir os arquivos da cópia de sombra. Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Vista.
`VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE` Valor: 0x4 A cópia de sombra especificada é uma cópia de sombra acessível pelo cliente que dá suporte a Cópias de Sombra para Pastas Compartilhadas e não deve ser exposta. Esse atributo é definido automaticamente para VSS_CTX_CLIENT_ACCESSIBLE e VSS_CTX_CLIENT_ACCESSIBLE_WRITERS. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE` Valor: 0x8 A cópia de sombra não é excluída automaticamente quando o processo do solicitante de cópia de sombra termina. A cópia de sombra pode ser excluído somente por uma chamada para IVssBackupComponents::D eleteSnapshots. Esse atributo é definido automaticamente para _VSS_SNAPSHOT_CONTEXT contextos de VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS e VSS_CTX_NAS_ROLLBACK. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_NO_WRITERS` Valor: 0x10 Nenhum gravador está envolvido na criação da cópia de sombra. Esse atributo é definido automaticamente para _VSS_SNAPSHOT_CONTEXT contextos de VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP e VSS_CTX_CLIENT_ACCESSIBLE. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_TRANSPORTABLE` Valor: 0x20 A cópia de sombra deve ser transportada e, portanto, não deve ser exibida localmente. Esse atributo pode ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra, se o O provedor de cópia de sombra dá suporte a cópias de sombra transportáveis. Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition e Windows XP: Não há suporte para esse atributo. Todas as edições do Windows Server 2003 com SP1 dão suporte a esse atributo. Consulte Importando transportável Volumes Copiados por Sombra para obter mais informações.
`VSS_VOLSNAP_ATTR_NOT_SURFACED` Valor: 0x40 A cópia de sombra não está exposta no momento. A menos que a cópia de sombra seja explicitamente exposta ou montada, esse atributo é definido para todas as cópias de sombra. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_NOT_TRANSACTED` Valor: 0x80 A cópia de sombra não é transacionada. Um solicitante pode modificar um contexto de cópia de sombra com um OR bit a bit desse atributo. Ao fazer isso, o solicitante instrui o VSS a desabilitar a integração interna entre o VSS e os gerenciadores de transações e recursos. Definir esse atributo garante que o solicitante não receberá erros VSS_E_TRANSACTION_FREEZE_TIMEOUT. No entanto, isso pode causar consequências indesejadas, como a perda de integridade transacional ou até mesmo a perda de dados. Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Vista.
`VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED` Valor: 0x10000 Indica que um determinado provedor é um provedor de hardware. Esse atributo é definido automaticamente para provedores de hardware. Esse valor de enumeração não pode ser usado para definir manualmente o contexto (usando o IVssBackupComponents::SetContext método) de uma cópia de sombra por uma máscara de bits (ou OR bit a bit) desse valor de enumeração e uma cópia de sombra válida valor de contexto de _VSS_SNAPSHOT_CONTEXT.
`VSS_VOLSNAP_ATTR_DIFFERENTIAL` Valor: 0x20000 Indica que um determinado provedor usa dados diferenciais ou um mecanismo de cópia na gravação para implementar cópias de sombra. Um solicitante pode modificar um contexto de cópia de sombra com um OR bit a bit desse atributo. Ao fazer isso, o O solicitante instrui os provedores a criar uma cópia de sombra usando uma implementação diferencial. Se nenhuma cópia de sombra o provedor instalado no sistema dá suporte aos atributos solicitados, um erro de VSS_E_VOLUME_NOT_SUPPORTED será retornado para IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_PLEX` Valor: 0x40000 Indica que um determinado provedor usa um mecanismo de divisão PLEX ou espelhado para implementar cópias de sombra. Um solicitante pode modificar um contexto de cópia de sombra com um OR bit a bit desse atributo. Ao fazer isso, o O solicitante instrui os provedores a criar uma cópia de sombra usando uma implementação PLEX. Se nenhuma cópia de sombra o provedor instalado no sistema dá suporte aos atributos solicitados, um erro de VSS_E_VOLUME_NOT_SUPPORTED será retornado para IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_IMPORTED` Valor: 0x80000 A cópia de sombra do volume foi importada para este computador usando o IVssBackupComponents::ImportSnapshots método em vez de criado usando o IVssBackupComponents::D oSnapshotSet método. Esse atributo será definido automaticamente se uma cópia de sombra for importada. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY` Valor: 0x100000 A cópia de sombra é exposta localmente. Se esse sinalizador de bits e o sinalizador de bits VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY forem não definido, a cópia de sombra está oculta. O atributo é adicionado automaticamente a um contexto de cópia de sombra ao chamar o IVssBackupComponents::ExposeSnapshot para expor uma cópia de sombra localmente. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY` Valor: 0x200000 A cópia de sombra é exposta remotamente. Se esse sinalizador de bits e o sinalizador de bits VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY forem não definido, a cópia de sombra está oculta. O atributo é adicionado automaticamente a um contexto de cópia de sombra ao chamar o IVssBackupComponents::ExposeSnapshot para expor uma cópia de sombra localmente. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_AUTORECOVER` Valor: 0x400000 Indica que o gravador precisará recuperar automaticamente o componente em CVssWriter::OnPostSnapshot. Esse atributo não deve ser usado explicitamente pelos solicitantes ao definir o contexto de uma cópia de sombra.
`VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY` Valor: 0x800000 Indica que o gravador precisará recuperar automaticamente o componente em CVssWriter::OnPostSnapshot se a cópia de sombra estiver sendo usada para reversão (para mineração de dados, por exemplo). Um solicitante definiria esse sinalizador no contexto de cópia de sombra para indicar que a cópia de sombra está sendo criada para uma finalidade que não seja de backup, como mineração de dados.
`VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT` Valor: 0x1000000 Reservado para uso do sistema. Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008.
`VSS_VOLSNAP_ATTR_TXF_RECOVERY` Valor: 0x2000000 Indica que a recuperação de TxF deve ser imposta durante a criação da cópia de sombra. Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008.
`VSS_VOLSNAP_ATTR_FILE_SHARE` Valor: 0x4000000

Comentários

O contexto padrão para cópias de sombra do VSS é VSS_CTX_BACKUP.

Um solicitante define o contexto de uma cópia de sombra prestes a ser criada passando o membro da enumeração _VSS_SNAPSHOT_CONTEXT para o método IVssBackupComponents::SetContext .

Os solicitantes podem modificar esse contexto usando um OR bit a bit do valor _VSS_SNAPSHOT_CONTEXT com um valor com suporte da enumeração _VSS_VOLUME_SNAPSHOT_ATTRIBUTES como um argumento para IVssBackupComponents::SetContext.

A menos que solicitado especificamente para dar suporte a um determinado mecanismo, os provedores são livres para usar qualquer tipo de mecanismo para implementar uma cópia de sombra. Portanto, no caso em que um método de cópia de sombra não é especificado, o provedor é livre para escolher um mecanismo diferencial (VSS_VOLSNAP_ATTR_DIFFERENTIAL), um mecanismo PLEX (VSS_VOLSNAP_ATTR_PLEX) ou qualquer outro mecanismo para dar suporte à cópia de sombra.

Embora um provedor possa dar suporte a ambos os mecanismos, eles são mutuamente exclusivos para uma determinada cópia de sombra. Os solicitantes não devem usar VSS_VOLSNAP_ATTR_DIFFERENTIAL e VSS_VOLSNAP_ATTR_PLEX para modificar um contexto de cópia de sombra específico.

Atualmente, VSS_VOLSNAP_ATTR_DIFFERENTIAL, VSS_VOLSNAP_ATTR_PLEX e VSS_VOLSNAP_ATTR_TRANSPORTABLE são os únicos valores da enumeração _VSS_VOLUME_SNAPSHOT_ATTRIBUTES que podem ser usados para modificar qualquer contexto.

Além disso, ele não pode ser usado para modificar um contexto de VSS_CTX_CLIENT_ACCESSIBLE .

Um solicitante pode obter informações sobre uma cópia de sombra específica (identificada por VSS_ID) descompactando a estrutura VSS_SNAPSHOT_PROP da estrutura VSS_OBJECT_PROP retornada por uma chamada para IVssBackupComponents::GetSnapshotProperties.

Um solicitante também pode obter uma estrutura VSS_SNAPSHOT_PROP para cada uma das várias cópias de sombra chamando IVssBackupComponents::Query e usando IVssEnumObject para iterar os retornos.

O contexto e os atributos das cópias de sombra são encontrados como uma máscara de bits contida no membro m_lSnapshotAttributes da estrutura VSS_SNAPSHOT_PROP .

Requisitos


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