Méthode IVssBackupComponents ::P repareForBackup (vsbackup.h)

Article
03/13/2024

La méthode PrepareForBackup entraîne la génération par VSS d’un événement PrepareForBackup , signalant aux enregistreurs de se préparer à une opération de sauvegarde à venir. Cela rend le document des composants de sauvegarde d’un demandeur disponible pour les rédacteurs.

Syntaxe

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

Paramètres

[out] ppAsync

Pointeur doublement indirect vers une instance de l’interface IVssAsync utilisée pour déterminer quand l’opération asynchrone est terminée.

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. Consultez IVssAsync ::QueryStatus pour connaître les codes d’erreur retournés dans 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.

Remarques

PrepareForBackup génère un événement PrepareForBackup, qui est géré par chaque instance de chaque rédacteur via la méthode CVssWriter ::OnPrepareBackup.

Pour que PrepareForBackup puisse être appelé, IVssBackupComponents ::SetBackupState doit être appelé.

Le document des composants de sauvegarde peut toujours être modifié par les rédacteurs dans leur gestionnaire d’événements PrepareForBackup (CVssWriter ::OnPrepareBackup), puis jusqu’à la génération d’un événement BackupComplete .

L’appelant est responsable de la libération de l’interface IVssAsync .

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