Méthode IVssSoftwareSnapshotProvider ::D eleteSnapshots (vsprov.h)

Article
08/27/2023

Supprime un ou plusieurs clichés instantanés ou un jeu de clichés instantanés.

Syntaxe

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

Paramètres

[in] SourceObjectId

Identificateur du cliché instantané ou du jeu de clichés instantanés à supprimer.

[in] eSourceObjectType

Type de l’objet à supprimer. La valeur de ce paramètre est VSS_OBJECT_SNAPSHOT ou VSS_OBJECT_SNAPSHOT_SET.

[in] bForceDelete

Si la valeur de ce paramètre est TRUE, le fournisseur fera tout son possible pour supprimer le cliché instantané ou les clichés instantanés dans un jeu de clichés instantanés. S’il est FALSE, aucun effort supplémentaire n’est effectué.

[out] plDeletedSnapshots

Pointeur vers une variable qui reçoit le nombre de clichés instantanés supprimés.

[out] pNondeletedSnapshotID

Si une erreur se produit, ce paramètre reçoit un pointeur vers l’identificateur du premier cliché instantané qui n’a pas pu être supprimé. Sinon, il pointe vers GUID_NULL.

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur	Signification
S_OK	Les clichés instantanés ont été supprimés.
E_ACCESSDENIED	L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_OBJECT_NOT_FOUND	Les clichés instantanés spécifiés sont introuvables.
VSS_E_PROVIDER_VETO	Erreur du fournisseur. Le fournisseur a enregistré l’erreur dans le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Remarques

Plusieurs clichés instantanés dans un jeu de clichés instantanés sont supprimés séquentiellement. Si une erreur se produit lors de l’une de ces suppressions individuelles, DeleteSnapshots retourne immédiatement ; aucune tentative de suppression des clichés instantanés restants ne sera effectuée. Le VSS_ID du cliché instantané non supprimé est retourné dans pNondeletedSnapshotID.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsprov.h
Bibliothèque	VssApi.lib

Voir aussi

IVssSoftwareSnapshotProvider

Partager via