Metodo IVssSoftwareSnapshotProvider::D eleteSnapshots (vsprov.h)

Articolo
08/27/2023

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 del set di copia shadow o copia shadow da eliminare.

[in] eSourceObjectType

Tipo dell'oggetto da eliminare. 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

Puntatore a una variabile che riceve il numero di copie shadow eliminate.

[out] pNondeletedSnapshotID

Se si verifica un errore, questo parametro riceve un puntatore all'identificatore della prima copia shadow che non è stato possibile eliminare. In caso contrario, punta a 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_OBJECT_NOT_FOUND	Le copie shadow specificate non sono state trovate.
VSS_E_PROVIDER_VETO	Errore del provider. Il provider ha registrato l'errore nel registro eventi. 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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsprov.h
Libreria	VssApi.lib

Vedi anche

IVssSoftwareSnapshotProvider

Condividi tramite