Metodo IVssBackupComponents::D eleteSnapshots (vsbackup.h)
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 |
---|---|
|
Le copie shadow sono state eliminate correttamente. |
|
Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
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. |
|
La copia shadow specificata non esiste. |
|
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. |
|
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 |