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

Article
03/13/2024

Supprime des instantanés spécifiques ou tous les instantanés d’un ensemble de instantané spécifié.

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

Le coordinateur VSS appelle cette méthode dans le cadre du processus de mise en production automatique instantané. La méthode est également appelée en réponse aux opérations de suppression pilotées par le demandeur.

Configuration requise

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

Voir aussi

IVssFileShareSnapshotProvider

Partager via