Compartilhar via


Método IVssProviderCreateSnapshotSet::AbortSnapshots (vsprov.h)

O método AbortSnapshots anula cópias de sombra preparadas neste provedor. Isso inclui todas as cópias de sombra não confirmadas e as pré-confirmadas.

Sintaxe

HRESULT AbortSnapshots(
  [in] VSS_ID SnapshotSetId
);

Parâmetros

[in] SnapshotSetId

O VSS_ID que identifica o conjunto de cópias de sombra.

Valor retornado

Esse método pode retornar um desses valores.

Valor/código retornado Descrição
S_OK
0x000000000L
A operação foi concluída com êxito.
E_OUTOFMEMORY
0x8007000EL
Sem memória ou outros recursos do sistema.
E_INVALIDARG
0x80070057L
Um dos valores de parâmetro não é válido.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
O parâmetro SnapshotSetId refere-se a um objeto que não foi encontrado.
VSS_E_PROVIDER_VETO
0x80042306L
Ocorreu um erro inesperado do provedor. O provedor deve registrar uma mensagem no log de eventos do aplicativo fornecendo ao usuário informações sobre como resolve o problema.

Comentários

O VSS só chamará AbortSnapshots depois que o solicitante chamar IVssBackupComponents::D oSnapshotSet, mesmo que a cópia de sombra falhe ou seja anulada antes desse ponto. Isso significa que um provedor não receberá uma chamada AbortSnapshots até que EndPrepareSnapshots seja chamado. Se uma cópia de sombra for anulada ou falhar antes desse ponto, o provedor não recebe nenhuma indicação até que uma nova cópia de sombra seja iniciada. Por esse motivo, o provedor deve estar preparado para lidar com uma chamada IVssHardwareSnapshotProvider::BeginPrepareSnapshot fora da sequência a qualquer momento. Essa chamada fora de sequência representa o início de uma nova sequência de criação de cópia de sombra e terá uma nova ID do conjunto de cópias de sombra.

Requisitos

   
Cliente mínimo com suporte Windows Vista [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 vsprov.h

Confira também

IVssProviderCreateSnapshotSet