Metodo IVssBackupComponentsEx2::BreakSnapshotSetEx (vsbackup.h)

Articolo
08/27/2023

Interrompe un set di copia shadow in base alle opzioni specificate dal richiedente.

Sintassi

HRESULT BreakSnapshotSetEx(
  [in]  VSS_ID    SnapshotSetID,
  [in]  DWORD     dwBreakFlags,
  [out] IVssAsync **ppAsync
);

Parametri

[in] SnapshotSetID

Identificatore del set di copia shadow.

[in] dwBreakFlags

Maschera di bit di flag di _VSS_HARDWARE_OPTIONS che specificano la modalità di interruzione del set di copia shadow.

[out] ppAsync

Puntatore a una variabile che riceve un puntatore dell'interfaccia IVssAsync che può essere usato per recuperare lo stato dell'operazione di interruzione del set di copia shadow. Al termine dell'operazione di interruzione, è necessario chiamare il metodo IUnknown::Release per questo puntatore dell'interfaccia.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK 0x00000000L	Il set di copia shadow è stato interrotto correttamente.
E_ACCESSDENIED 0x80070005L	Il chiamante non dispone di privilegi sufficienti o non è un amministratore.
E_INVALIDARG 0x80070057L	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY 0x8007000EL	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BREAK_REVERT_ID_FAILED 0x800423F6L	L'operazione di interruzione del set di copia shadow non è riuscita perché la firma del disco MBR, l'identificatore del disco GPT o l'identificatore di partizione GPT di uno o più dei LUN di destinazione non è stato possibile ripristinare quelli delle LUN originali. Se uno o più LUN originali non sono mascherati nel computer, l'operazione di interruzione causerebbe una collisione di firma.
VSS_E_OBJECT_NOT_FOUND 0x80042308L	La copia shadow specificata non esiste.
VSS_E_PROVIDER_VETO 0x80042306L	La copia shadow è stata creata da un provider software e non può essere interrotta.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

BreakSnapshotSetEx è simile al metodo IVssBackupComponents::BreakSnapshotSet , ad eccezione del fatto che dispone di parametri aggiuntivi per eseguire query sullo stato e specificare la modalità di interruzione del set di copia shadow.

Come BreakSnapshotSet, BreakSnapshotSetEx può essere usato solo per le copie shadow create da un provider di copia shadow hardware.

Dopo che questo metodo restituisce, il volume di copia shadow è ancora un volume, ma non è più una copia shadow. Per altre informazioni, vedere Copie shadow di interruzione.

Requisiti


Client minimo supportato	Windows Vista con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)

Condividi tramite