Méthode IVssBackupComponentsEx2::BreakSnapshotSetEx (vsbackup.h)

  • Article

Interrompt un jeu de clichés instantanés en fonction des options spécifiées par le demandeur.

Syntaxe

HRESULT BreakSnapshotSetEx(
  [in]  VSS_ID    SnapshotSetID,
  [in]  DWORD     dwBreakFlags,
  [out] IVssAsync **ppAsync
);

Paramètres

[in] SnapshotSetID

Identificateur d’un jeu de clichés instantanés.

[in] dwBreakFlags

Masque de bits de _VSS_HARDWARE_OPTIONS indicateurs qui spécifient la façon dont le jeu de clichés instantanés est rompu.

[out] ppAsync

Pointeur vers une variable qui reçoit un pointeur d’interface IVssAsync qui peut être utilisé pour récupérer le status de l’opération d’arrêt du jeu de cliché instantané. Une fois l’opération d’arrêt terminée, la méthode IUnknown::Release doit être appelée pour ce pointeur d’interface.

Valeur retournée

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

Valeur Signification
S_OK
0x000000000L
 Le jeu de clichés instantanés a été rompu.
E_ACCESSDENIED
0x80070005L
 L’appelant ne dispose pas de privilèges suffisants ou n’est pas administrateur.
E_INVALIDARG
0x80070057L
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
0x8007000EL
 L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_BREAK_REVERT_ID_FAILED
0x800423F6L
 L’opération d’arrêt du jeu de cliché instantané a échoué, car la signature du disque MBR, l’identificateur de disque GPT ou l’identificateur de partition GPT d’une ou de plusieurs des LUN de destination n’ont pas pu être rétablis à ceux des LUN d’origine. Si un ou plusieurs LUN d’origine ne sont pas masqués sur l’ordinateur, l’opération d’arrêt provoquerait une collision de signature.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 Le cliché instantané spécifié n’existe pas.
VSS_E_PROVIDER_VETO
0x80042306L
 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

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

Comme BreakSnapshotSet, BreakSnapshotSetEx ne peut être utilisé que pour les clichés instantanés créés par un fournisseur de clichés instantanés matériels.

Une fois cette méthode retournée, le volume de cliché instantané est toujours un volume, mais il ne s’agit plus d’un cliché instantané. Pour plus d’informations, consultez Cassant les clichés instantanés.

Configuration requise

   
Client minimal pris en charge Windows Vista avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)