Método IVssBackupComponents::SetContext (vsbackup.h)

Artigo
08/27/2023

O método SetContext define o contexto para operações subsequentes relacionadas à cópia de sombra.

Sintaxe

HRESULT SetContext(
  [in] LONG lContext
);

Parâmetros

[in] lContext

O contexto a ser definido. O contexto deve ser um dos valores com suporte de _VSS_SNAPSHOT_CONTEXT ou uma máscara de bits com suporte (ou OR bit a bit) de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES com uma _VSS_SNAPSHOT_CONTEXT válida.

Valor retornado

O valor retornado padrão desse método é S_OK. Veja a seguir os códigos de retorno válidos para esse método.

Valor	Significado
S_OK	Defina o contexto com êxito.
E_INVALIDARG	Um dos valores de parâmetro não é válido.
VSS_E_BAD_STATE	O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta.
VSS_E_UNEXPECTED	Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros em VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado.

Comentários

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

Windows XP: O único contexto com suporte é o contexto padrão, VSS_CTX_BACKUP. Portanto, chamar SetContext no Windows XP retorna E_NOTIMPL.

SetContext pode ser chamado apenas uma vez e deve ser chamado antes de chamar a maioria das funções vss.

Para obter detalhes sobre como o contexto definido por IVssBackupComponents::SetContext afeta como uma cópia de sombra é criada e gerenciada, consulte Detalhes da implementação para criar cópias de sombra.

Para obter uma discussão completa sobre os contextos de cópia de sombra permitidos, consulte _VSS_SNAPSHOT_CONTEXT e _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

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]
Plataforma de Destino	Windows
Cabeçalho	vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)
Biblioteca	VssApi.lib