Partager via


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

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

Voir aussi

IVssAsync

IVssBackupComponents

IVssBackupComponents ::AddComponent

IVssBackupComponents ::AddToSnapshotSet

IVssBackupComponents ::StartSnapshotSet

IVssComponent