VSS_FILE_RESTORE_STATUS énumération (vswriter.h)

Article
03/03/2024

L’énumération VSS_FILE_RESTORE_STATUS définit l’ensemble des états d’une opération de restauration de fichiers effectuée sur les fichiers gérés par un composant ou un ensemble de composants sélectionnés (pour plus d’informations sur la sélection de composants, consultez Utilisation de la sélection et des chemins logiques).

Syntax

typedef enum VSS_FILE_RESTORE_STATUS {
  VSS_RS_UNDEFINED = 0,
  VSS_RS_NONE,
  VSS_RS_ALL,
  VSS_RS_FAILED
} ;

Constantes


`VSS_RS_UNDEFINED` Valeur : 0 L’état de restauration n’est pas défini. Cette valeur indique une erreur ou indique qu’une opération de restauration n’a pas encore démarré. Cette valeur n’est pas prise en charge pour les composants appartenant aux enregistreurs express.
`VSS_RS_NONE` Aucun fichier n’a été restauré. Cette valeur indique une erreur de restauration qui n’a laissé aucun fichier restauré sur le disque.
`VSS_RS_ALL` Tous les fichiers ont été restaurés. Cette valeur indique la réussite et doit être définie pour chaque composant qui a été restauré avec succès.
`VSS_RS_FAILED` Le processus de restauration a échoué. Cette valeur indique une erreur de restauration qui a laissé certains fichiers restaurés sur le disque. Cela signifie que les composants sur le disque sont maintenant endommagés.

Remarques

Si des fichiers gérés par un composant ou, s’il définit un ensemble de composants, l’un de ses sous-composants ne peut pas être restauré, la valeur de VSS_FILE_RESTORE_STATUS doit indiquer une erreur.

Les valeurs VSS_RS_FAILED et VSS_RS_NONE indiquent qu’une opération de restauration n’a pas réussi :

VSS_RS_NONE indique qu’une restauration a échoué correctement : aucun fichier du composant ou de ses sous-composants n’a été restauré sur le disque.
VSS_RS_FAIL indique qu’une restauration a échoué sans succès, laissant certains fichiers restaurés sur le disque et certains fichiers non autorisés.

Les demandeurs doivent définir un status de restauration (à l’aide d’IVssBackupComponents ::SetFileRestoreStatus) pour chaque composant (et son jeu de composants, s’il en définit un) explicitement ajouté pour la restauration dans le document de composants de sauvegarde (à l’aide d’IVssBackupComponents ::SetSelectedForRestore Ou IVssBackupComponents ::AddRestoreSubcomponent).

Les rédacteurs et les demandeurs peuvent interroger la status de la restauration d’un composant ou d’un ensemble de composants défini par un composant sélectionnable avec des appels à IVssComponent ::GetFileRestoreStatus. Si cette méthode est appelée pour un composant qui n’a pas été sélectionné, la valeur retournée n’est pas définie.

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]
En-tête	vswriter.h

Voir aussi

IVssBackupComponents ::SetFileRestoreStatus

IVssComponent ::GetFileRestoreStatus

Partager via