Partager via

Méthode IVssProviderCreateSnapshotSet::AbortSnapshots (vsprov.h)

  • Article

La méthode AbortSnapshots abandonne les clichés instantanés préparés dans ce fournisseur. Cela inclut tous les clichés instantanés non engagés et les clichés prédéfins.

Syntaxe

HRESULT AbortSnapshots(
  [in] VSS_ID SnapshotSetId
);

Paramètres

[in] SnapshotSetId

VSS_ID qui identifie le jeu de clichés instantanés.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour Description
S_OK
0x000000000L
 L’opération s’est terminée avec succès.
E_OUTOFMEMORY
0x8007000EL
 Mémoire insuffisante ou autres ressources système.
E_INVALIDARG
0x80070057L
 L’une des valeurs de paramètre n’est pas valide.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 Le paramètre SnapshotSetId fait référence à un objet introuvable.
VSS_E_PROVIDER_VETO
0x80042306L
 Une erreur de fournisseur inattendue s’est produite. Le fournisseur doit enregistrer un message dans le journal des événements de l’application pour fournir à l’utilisateur des informations sur la façon de résoudre le problème.

Remarques

VSS appelle uniquement AbortSnapshots une fois que le demandeur a appelé IVssBackupComponents::D oSnapshotSet, même si le cliché instantané échoue ou est abandonné avant ce stade. Cela signifie qu’un fournisseur ne recevra pas d’appel AbortSnapshots tant que EndPrepareSnapshots n’aura pas été appelé. Si un cliché instantané est abandonné ou échoue avant ce point, le fournisseur ne reçoit aucune indication tant qu’un nouveau cliché instantané n’est pas démarré. Pour cette raison, le fournisseur doit être prêt à gérer un appel hors séquence IVssHardwareSnapshotProvider::BeginPrepareSnapshot à tout moment. Cet appel hors séquence représente le début d’une nouvelle séquence de création de cliché instantané et aura un nouvel ID de jeu de cliché instantané.

Configuration requise

   
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

Voir aussi

IVssProviderCreateSnapshotSet