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

Article
08/27/2023

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)

Partager via