Método IVssBackupComponentsEx2::BreakSnapshotSetEx (vsbackup.h)
Quebra um conjunto de cópias de sombra de acordo com as opções especificadas pelo solicitante.
Sintaxe
HRESULT BreakSnapshotSetEx(
[in] VSS_ID SnapshotSetID,
[in] DWORD dwBreakFlags,
[out] IVssAsync **ppAsync
);
Parâmetros
[in] SnapshotSetID
Um identificador de conjunto de cópias de sombra.
[in] dwBreakFlags
Uma máscara de bits de sinalizadores de _VSS_HARDWARE_OPTIONS que especificam como o conjunto de cópias de sombra está quebrado.
[out] ppAsync
Um ponteiro para uma variável que recebe um ponteiro de interface IVssAsync que pode ser usado para recuperar o status da operação de interrupção do conjunto de cópias de sombra. Quando a operação de interrupção for concluída, o método IUnknown::Release deverá ser chamado para esse ponteiro de interface.
Valor retornado
Veja a seguir os códigos de retorno válidos para esse método.
| Valor | Significado |
|---|---|
|
O conjunto de cópias de sombra foi quebrado com êxito. |
|
O chamador não tem privilégios suficientes ou não é um administrador. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
A operação de interrupção do conjunto de cópias de sombra falhou porque a assinatura do disco MBR, o identificador de disco GPT ou o identificador de partição GPT de um ou mais LUNs de destino não puderam ser revertidos para aqueles dos LUNs originais. Se um ou mais LUNs originais não estiverem mascarados no computador, a operação de interrupção causará uma colisão de assinatura. |
|
A cópia de sombra especificada não existe. |
|
A cópia de sombra foi criada por um provedor de software e não pode ser interrompida. |
|
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
BreakSnapshotSetEx é semelhante ao método IVssBackupComponents::BreakSnapshotSet, exceto que ele tem parâmetros extras para consultar status e especificar como o conjunto de cópias de sombra está quebrado.
Assim como BreakSnapshotSet, BreakSnapshotSetEx só pode ser usado para cópias de sombra que foram criadas por um provedor de cópia de sombra de hardware.
Depois que esse método retorna, o volume de cópia de sombra ainda é um volume, mas não é mais uma cópia de sombra. Para obter mais informações, consulte Breaking Shadow Copies.
Requisitos
| Cliente mínimo com suporte | Windows Vista com SP1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h) |