VSS_SNAPSHOT_CONTEXT enumeração (vss.h)

Artigo
08/27/2023

A enumeração _VSS_SNAPSHOT_CONTEXT permite que um solicitante usando IVssBackupComponents::SetContext especifique como uma cópia de sombra deve ser criada, consultada ou excluída e o grau de envolvimento do gravador.

Syntax

typedef enum _VSS_SNAPSHOT_CONTEXT {
  VSS_CTX_BACKUP = 0,
  VSS_CTX_FILE_SHARE_BACKUP,
  VSS_CTX_NAS_ROLLBACK,
  VSS_CTX_APP_ROLLBACK,
  VSS_CTX_CLIENT_ACCESSIBLE,
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS,
  VSS_CTX_ALL = 0xffffffff
} VSS_SNAPSHOT_CONTEXT, *PVSS_SNAPSHOT_CONTEXT;

Constantes


`VSS_CTX_BACKUP` Valor: 0 O contexto de backup padrão. Especifica uma cópia de sombra não persistente e de liberação automática na qual os gravadores são envolvido na criação.
`VSS_CTX_FILE_SHARE_BACKUP` Especifica uma cópia de sombra nãopersistent criada automaticamente sem envolvimento do gravador.
`VSS_CTX_NAS_ROLLBACK` Especifica uma cópia de sombra persistente, não de versão automática, sem envolvimento do gravador. Esse contexto deve ser usado quando não há necessidade de envolvimento do gravador para garantir que os arquivos estejam em um estado consistente no momento da cópia de sombra. Mecanismos de reversão de arquivos automatizados leves ou cópias de sombra persistentes de compartilhamentos de arquivos ou volumes de dados que não devem conter arquivos ou bancos de dados relacionados ao sistema podem ser executados nesse contexto. For (para) por exemplo, um solicitante poderia usar esse contexto para criar uma cópia de sombra de um volume nas hospedando documentos e compartilhamentos de usuário simples. Esses tipos de dados não precisam de envolvimento do gravador para criar uma cópia de sombra consistente.
`VSS_CTX_APP_ROLLBACK` Especifica uma cópia de sombra persistente, não de versão automática, com envolvimento do gravador. Esse contexto foi projetado a ser usado quando os gravadores são necessários para garantir que os arquivos estejam em um estado bem definido antes da cópia de sombra. Mecanismos automatizados de reversão de arquivos de volumes do sistema e cópias de sombra a serem usados na mineração ou restauração de dados as operações podem ser executadas nesse contexto. Esse contexto é semelhante ao VSS_CTX_BACKUP mas permite que um solicitante controle mais sobre a persistência da cópia de sombra.
`VSS_CTX_CLIENT_ACCESSIBLE` Especifica uma cópia de sombra somente leitura e acessível pelo cliente que dá suporte a Cópias de Sombra para Pastas Compartilhadas e é criada sem o envolvimento do gravador. Somente o provedor do sistema (o provedor padrão disponível no sistema) pode criar esse tipo de cópia de sombra. A maioria dos solicitantes deseja usar o contexto VSS_CTX_NAS_ROLLBACK para cópias de sombra persistentes e não de lançamento automático sem envolvimento do gravador.
`VSS_CTX_CLIENT_ACCESSIBLE_WRITERS` Especifica uma cópia de sombra somente leitura e acessível pelo cliente criada com envolvimento do gravador. Somente o provedor do sistema (o provedor padrão disponível no sistema) pode criar esse tipo de cópia de sombra. A maioria dos solicitantes deseja usar o contexto VSS_CTX_APP_ROLLBACK para cópias de sombra persistentes e não de lançamento automático com envolvimento do gravador. Windows Server 2003 e Windows XP: Não há suporte para esse contexto no Windows Server 2003 e no Windows XP.
`VSS_CTX_ALL` Valor: 0xffffffff Todos os tipos de cópias de sombra dinâmica atualmente estão disponíveis para operações administrativas, como cópia de sombra consultas (consulte IVssBackupComponents::Query). VSS_CTX_ALL é um contexto válido para todas as interfaces VSS, exceto IVssBackupComponents::StartSnapshotSet e IVssBackupComponents::D oSnapshotSet.

Comentários

O tipo de dados a ser usado com valores de _VSS_SNAPSHOT_CONTEXT é LONG.

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

Windows XP: O único contexto com suporte é o padrão, VSS_CTX_BACKUP. Chamar IVssBackupComponents::SetContext retornará E_NOTIMPL.

Para obter detalhes sobre como usar contextos de cópias de sombra do VSS, consulte Detalhes de implementação para criar cópias de sombra.

O comportamento de cópia de sombra pode ser ainda mais controlado usando um OR bit a bit para combinar um _VSS_VOLUME_SNAPSHOT_ATTRIBUTES com suporte com valores de _VSS_SNAPSHOT_CONTEXT válidos como um argumento para o método IVssBackupComponents::SetContext .

Atualmente, as únicas modificações com suporte são o OR bit a bit de um valor _VSS_SNAPSHOT_CONTEXT com o VSS_VOLSNAP_ATTR_TRANSPORTABLE e o VSS_VOLSNAP_ATTR_DIFFERENTIAL ou o valor VSS_VOLSNAP_ATTR_PLEX da enumeração _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

No entanto, esses valores não podem ser usados para modificar VSS_CTX_CLIENT_ACCESSIBLE contexto.

O uso de VSS_VOLSNAP_ATTR_TRANSPORTABLE é limitado a sistemas que executam o Windows Server 2008 Enterprise, Windows Server 2008 Datacenter, Windows Server 2003, Edição Enterprise ou Windows Server 2003, Datacenter Edition.

Requisitos

Requisito	Valor
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