Méthode IDedupBackupSupport ::RestoreFiles (ddpbackup.h)
Reconstruit un ensemble de fichiers à partir d’un magasin de sauvegarde qui contient la version entièrement optimisée des fichiers (points d’analyse) et le magasin de déduplication des données.
Les applications qui appellent la méthode RestoreFiles doivent également implémenter l’interface IDedupReadFileCallback . Avant d’appeler la méthode RestoreFiles , l’application doit avoir précédemment restauré les points d’analyse de déduplication des données pour les fichiers à l’emplacement spécifié par le paramètre FileFullPaths . Les métadonnées situées dans les points d’analyse seront utilisées par la déduplication des données pour poursuivre le processus de restauration.
Après avoir appelé cette méthode, les applications peuvent s’attendre à recevoir deux appels à IDedupReadFileCallback ::OrderContainersRestore (un pour les conteneurs de mappage de flux et un pour les conteneurs de données) et deux appels ou plus à IDedupReadFileCallback ::ReadBackupFile. L’application recevra également un appel à IDedupReadFileCallback ::P reviewContainerRead avant chaque appel à ReadBackupFile dirigé vers un fichier conteneur.
Syntaxe
HRESULT RestoreFiles(
[in] ULONG NumberOfFiles,
[in] BSTR *FileFullPaths,
[in] IDedupReadFileCallback *Store,
[in] DWORD Flags,
[out] HRESULT *FileResults
);
Paramètres
[in] NumberOfFiles
Nombre de fichiers à restaurer. Si cette valeur dépasse 10 000, la méthode échoue avec E_INVALIDARG (0x80070057).
[in] FileFullPaths
Pour chaque fichier, ce paramètre contient le chemin d’accès complet du répertoire racine du volume au point d’analyse précédemment restauré par l’application.
[in] Store
Pointeur d’interface IDedupReadFileCallback pour le magasin de sauvegarde. Ce paramètre est obligatoire et ne peut pas être NULL.
[in] Flags
Ce paramètre doit être DEDUP_RECONSTRUCT_UNOPTIMIZED lors de l’entrée . Pour plus d’informations, consultez l’énumération DEDUP_BACKUP_SUPPORT_PARAM_TYPE .
[out] FileResults
Pour chaque fichier, ce paramètre contient les résultats de l’opération de restauration pour ce fichier. Ce paramètre est facultatif et peut être NULL si l’application n’a pas besoin de connaître les résultats de chaque fichier individuel.
S_OK (0x00000000L)
Le fichier a été restauré avec succès.
S_FALSE (0x00000001L)
Le fichier spécifié n’est pas un fichier dédupliqué.
DDP_E_FILE_CORRUPT (0x80565355L)
La déduplication des données a rencontré une erreur d’altération du fichier.
DDP_E_FILE_SYSTEM_CORRUPT (0x8056530EL)
La déduplication des données a rencontré une erreur d’altération du système de fichiers.
DDP_E_INVALID_DATA (0x8056531DL)
Les données ne sont pas correctes.
DDP_E_JOB_COMPLETED_PARTIAL_SUCCESS (0x80565356L)
L’opération s’est terminée avec des erreurs. Pour plus d’informations, consultez les journaux des événements.
Windows Server 2012 : cette valeur n’est pas prise en charge avant Windows Server 2012 R2.
DDP_E_NOT_FOUND (0x80565301L)
L'objet demandé est introuvable.
DDP_E_PATH_NOT_FOUND (0x80565304L)
Un chemin d’accès de conteneur spécifié est introuvable dans le magasin de sauvegarde.
DDP_E_UNEXPECTED (0x8056530CL)
La déduplication des données a rencontré une erreur inattendue. Pour plus d’informations, consultez le journal des événements opérationnel de déduplication des données.
DDP_E_VOLUME_DEDUP_DISABLED (0x80565323L)
Le volume spécifié n’est pas activé pour la déduplication.
DDP_E_VOLUME_UNSUPPORTED (0x8056530bL)
Le type de volume spécifié n’est pas pris en charge. La déduplication est prise en charge sur les volumes de données NTFS fixes et compatibles avec l’écriture.
Windows Server 2012 : cette valeur n’est pas prise en charge avant Windows Server 2012 R2.
Valeur retournée
Cette méthode peut retourner des valeurs HRESULT standard, telles que S_OK. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Vous pouvez tester les valeurs HRESULT de réussite ou d’échec à l’aide des macros SUCCEEDED et FAILED définies dans Winerror.h. Les valeurs de retour possibles sont les suivantes.
Si aucun fichier n’a été restauré avec succès, le résultat est la première erreur de fichier rencontrée. Il s’agit de l’un des codes d’erreur « DDP_E_XXX » ci-dessus.
Remarques
Le paramètre Store est requis, car le moteur de restauration (implémenté par la déduplication des données) peut lire les données du support de sauvegarde uniquement en appelant la méthode IDedupReadFileCallback ::ReadBackupFile .
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Aucun pris en charge |
Serveur minimal pris en charge | Windows Server 2012 |
Plateforme cible | Windows |
En-tête | ddpbackup.h |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez :Envoyer et afficher des commentaires pour