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

DEDUP_BACKUP_SUPPORT_PARAM_TYPE

IDedupBackupSupport

IDedupReadFileCallback