Metodo IVssFileShareSnapshotProvider::D eleteSnapshots (vsprov.h)

Articolo
03/03/2024

Elimina snapshot specifici o tutti gli snapshot in un set di snapshot specificato.

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 copia 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 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

Il coordinatore di VSS chiama questo metodo come parte del processo di rilascio automatico dello snapshot. Il metodo viene chiamato anche in risposta alle operazioni di eliminazione guidate dal richiedente.

Requisiti

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

Vedi anche

IVssFileShareSnapshotProvider

Condividi tramite