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

  • Article

La méthode PreRestore va amener VSS à générer un événement PreRestore , signalant aux enregistreurs de se préparer pour une opération de restauration à venir.

Syntaxe

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

Paramètres

[out] ppAsync

Pointeur doublement indirect vers un objet IVssAsync contenant status données pour l’événement signalé.

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 codes d’erreur retournés dans le paramètre pHrResult .
E_INVALIDARG
 Le paramètre 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

L’appelant est responsable de la libération du pointeur d’interface IVssAsync .

Une attention particulière doit être accordée aux systèmes EFI lorsque le demandeur a sélectionné l’enregistreur ASR (Automated System Recovery) pour la restauration. Si vous restaurez sur un disque qui contient la partition EFI et que l’une des conditions suivantes existe, vous devez d’abord propre le disque en appelant la méthode IVdsAdvancedDisk ::Clean :

  • Vous restaurez sur un disque système EFI dont le partitionnement a changé depuis la dernière sauvegarde ASR.
  • Vous restaurez sur un lecteur physique différent de celui à partir duquel la sauvegarde a été effectuée.
L’échec de cette étape de nettoyage de disque peut entraîner des résultats inattendus pendant PreRestore.

Pour plus d’informations sur l’enregistreur ASR, consultez Enregistreurs VSS in-box.

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