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

  • Article

La méthode SetRestoreState définit une configuration globale pour une opération de restauration.

Syntaxe

HRESULT SetRestoreState(
  [in] VSS_RESTORE_TYPE restoreType
);

Paramètres

[in] restoreType

Valeur d’énumération VSS_RESTORE_TYPE indiquant le type de restauration à effectuer.

Valeur retournée

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

Valeur Signification
S_OK
 Définissez correctement l’état de sauvegarde.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE
 L’objet des composants de sauvegarde n’est pas initialisé, cette méthode a été appelée pendant une opération de sauvegarde ou cette méthode n’a pas été appelée dans la séquence correcte.
VSS_E_INVALID_XML_DOCUMENT
 Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
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

En règle générale, la plupart des opérations de restauration n’ont pas besoin de remplacer le type de restauration par défaut (VSS_RTYPE_UNDEFINED). Les rédacteurs doivent traiter ce type de restauration comme s’il était VSS_RTYPE_BY_COPY.

Si les applications doivent appeler SetRestoreState, il doit être appelé avant d’appeler IVssBackupComponents::P reRestore.

Si SetRestoreState n’est pas appelé avant IVssBackupComponents::P reRestore, l’état de restauration par défaut () est utilisé.

Configuration requise

   
Client minimal pris en charge Windows Vista [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

IVssBackupComponents

IVssBackupComponents::SetBackupState

VSS_BACKUP_TYPE

VSS_RESTORE_TYPE