Metodo IVssBackupComponents::D eleteSnapshots (vsbackup.h)

Articolo
03/13/2024

Il metodo DeleteSnapshots elimina una o più copie shadow o un set di copie shadow.

Sintassi

HRESULT DeleteSnapshots(
  [in]  VSS_ID          SourceObjectId,
  [in]  VSS_OBJECT_TYPE eSourceObjectType,
  [in]  BOOL            bForceDelete,
  [out] LONG            *plDeletedSnapshots,
  [out] VSS_ID          *pNondeletedSnapshotID
);

Parametri

[in] SourceObjectId

Identificatore della copia shadow o di un set di copie shadow da eliminare.

[in] eSourceObjectType

Tipo dell'oggetto in cui verranno eliminate tutte le copie shadow. Il valore di questo parametro è VSS_OBJECT_SNAPSHOT o VSS_OBJECT_SNAPSHOT_SET.

[in] bForceDelete

Se il valore di questo parametro è TRUE, il provider eseguirà tutto il possibile per eliminare la copia shadow o le copie shadow in un set di copie shadow. Se è FALSE, non verrà effettuato alcun ulteriore sforzo.

[out] plDeletedSnapshots

Numero di copie shadow eliminate.

[out] pNondeletedSnapshotID

Se si verifica un errore, il valore di questo parametro è l'identificatore della prima copia shadow che non è stato possibile eliminare. In caso contrario, è GUID_NULL.

Valore restituito

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

Valore	Significato
S_OK	Le copie shadow sono state eliminate correttamente.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
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.
VSS_E_OBJECT_NOT_FOUND	La copia shadow specificata non esiste.
VSS_E_PROVIDER_VETO	Errore previsto del provider. Il provider ha registrato l'errore nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Errore imprevisto del provider. Il codice di errore viene registrato nel log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.

Commenti

Più copie shadow in un set di copie shadow vengono eliminate in sequenza. Se si verifica un errore durante una di queste singole eliminazioni, DeleteSnapshots restituirà immediatamente; non verrà effettuato alcun tentativo di eliminare eventuali copie shadow rimanenti. La VSS_ID della copia shadow non recapitata viene restituita in pNondeletedSnapshotID.

Il richiedente è responsabile della serializzazione dell'operazione di eliminazione della copia shadow.

Durante un backup, le copie shadow vengono rilasciate automaticamente non appena viene rilasciata l'istanza IVssBackupComponents . In questo caso, non è necessario eliminare in modo esplicito le copie shadow.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssBackupComponents

IVssBackupComponents::StartSnapshotSet

VSS_ID