Compartilhar via

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

  • Artigo

O método BreakSnapshotSet faz com que a existência de um conjunto de cópias de sombra seja "esquecida" pelo VSS.

Sintaxe

HRESULT BreakSnapshotSet(
  [in] VSS_ID SnapshotSetId
);

Parâmetros

[in] SnapshotSetId

Identificador do conjunto de cópias de sombra.

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
 O conjunto de cópias de sombra foi quebrado com êxito.
E_ACCESSDENIED
 O chamador não tem privilégios de backup suficientes ou não é um administrador.
E_INVALIDARG
 Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.
VSS_E_OBJECT_NOT_FOUND
 A cópia de sombra especificada não existe.
VSS_E_PROVIDER_VETO
 A cópia de sombra foi criada por um provedor de software e não pode ser interrompida.
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

BreakSnapshotSet só pode ser usado para cópias de sombra criadas por um provedor de cópia de sombra de hardware. Esse método faz com que essas sombras copiem volumes regulares.

Cópias de sombra de volumes "quebrados" com BreakSnapshotSet devem ser gerenciadas independentemente do VSS como volumes autônomos. Consulte Breaking Shadow Copies para obter mais informações.

IVssBackupComponentsEx2::BreakSnapshotSetEx é semelhante ao método BreakSnapshotSet, exceto que ele tem parâmetros extras para consultar status e especificar como o conjunto de cópias de sombra está quebrado.

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

Confira também

IVssBackupComponents

IVssBackupComponents::D eleteSnapshots