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

Article
08/27/2023

La méthode BackupComplete permet à VSS de générer un événement BackupComplete , qui signale aux enregistreurs que le processus de sauvegarde est terminé.

Syntaxe

HRESULT BackupComplete(
  [out] IVssAsync **ppAsync
);

Paramètres

[out] ppAsync

Pointeur doublement indirect vers un instance IVssAsync.

Valeur retournée

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

Valeur	Signification
S_OK	Retour réussi d’un pointeur vers un instance de l’interface IVssAsync. Reportez-vous à IVssAsync::QueryStatus pour connaître les valeurs valides retournées par le paramètre pHrResult .
E_INVALIDARG	ppAsync ne pointe pas vers un pointeur valide ; c’est-à-dire qu’il est NULL.
E_OUTOFMEMORY	L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE	L’objet de composants de sauvegarde n’est pas initialisé, cette méthode a été appelée lors d’une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte.
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.
VSS_E_UNEXPECTED_WRITER_ERROR	Une erreur inattendue s’est produite lors de la communication avec les enregistreurs. 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.

Remarques

Lorsque vous travaillez en mode composant (IVssBackupComponents::SetBackupState a été appelé avec un argument de composants sélectionnés true), les rédacteurs peuvent déterminer la réussite ou l’échec de la sauvegarde de n’importe quel composant explicitement inclus dans les composants de document de sauvegarde à l’aide d’IVssComponent::GetBackupSucceed. Par conséquent, une application de sauvegarde bien conduite (demandeur) doit appeler IVssBackupComponents::SetBackupSucceeded après que chaque composant a été traité et avant d’appeler BackupComplete.

N’appelez pas cette méthode si l’appel à IVssBackupComponents::D oSnapshotSet a échoué. Pour plus d’informations sur la façon dont les demandeurs utilisent DoSnapshotSet, SetBackupSucceed etBackupComplete dans une opération de sauvegarde, consultez Vue d’ensemble des tâches de pré-sauvegarde et Vue d’ensemble de la sauvegarde réelle des fichiers.

Cette opération est asynchrone. L’appelant peut utiliser la méthode d’interface QueryStatus dans l’interface IVssAsync retournée pour déterminer le status de la notification.

Après avoir appelé BackupComplete, les demandeurs doivent appeler GatherWriterStatus pour que la session d’écriture soit définie sur un état terminé.

Note Cela n’est nécessaire que sur Windows Server 2008 avec Service Pack 2 (SP2) et versions antérieures.

L’application de sauvegarde peut choisir d’abandonner la sauvegarde à tout moment après la création du cliché instantané en appelant IVssAsync::Cancel.

L’application appelante est responsable de l’appel de IUnknown::Release pour libérer les ressources détenues par les IVssAsync retournés lorsqu’il n’est plus nécessaire.

Configuration requise


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