Méthode IVssBackupComponents ::BreakSnapshotSet (vsbackup.h)

  • Article

La méthode BreakSnapshotSet fait que l’existence d’un jeu de clichés instantanés est « oubliée » par VSS.

Syntaxe

HRESULT BreakSnapshotSet(
  [in] VSS_ID SnapshotSetId
);

Paramètres

[in] SnapshotSetId

Identificateur du jeu de cliché instantané.

Valeur retournée

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

Valeur Signification
S_OK
 Le jeu de clichés instantanés a été rompu.
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
 Le cliché instantané spécifié n’existe pas.
VSS_E_PROVIDER_VETO
 Le cliché instantané a été créé par un fournisseur de logiciels et ne peut pas être rompu.
VSS_E_UNEXPECTED
 Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place.

Remarques

BreakSnapshotSet ne peut être utilisé que pour les clichés instantanés créés par un fournisseur de clichés instantanés matériels. Cette méthode effectue ces clichés instantanés de volumes réguliers.

Les clichés instantanés des volumes « rompus » avec BreakSnapshotSet doivent être gérés indépendamment de VSS en tant que volumes autonomes. Pour plus d’informations, consultez Clichés instantanés cassants .

IVssBackupComponentsEx2 ::BreakSnapshotSetEx est similaire à la méthode BreakSnapshotSet, sauf qu’elle a des paramètres supplémentaires pour interroger status et spécifier la façon dont le jeu de clichés instantanés est rompu.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)
Bibliothèque VssApi.lib

Voir aussi

IVssBackupComponents

IVssBackupComponents ::D eleteSnapshots