Méthode IDedupReadFileCallback ::OrderContainersRestore (ddpbackup.h)

  • Article

Cette méthode permet à l’application d’influencer l’ordre des lectures en attente requises pour récupérer le fichier cible.

Avec une liste de fichiers conteneur qui contiennent des données pour le fichier cible de restauration, génère une liste d’extensions de fichier conteneur dans un ordre trié qui aboutit à un plan de lecture entre conteneurs efficace à partir du magasin de sauvegarde.

L’implémentation de cette méthode par l’application est facultative.

Syntaxe

HRESULT OrderContainersRestore(
  [in]  ULONG                  NumberOfContainers,
  [in]  BSTR                   *ContainerPaths,
  [out] ULONG                  *ReadPlanEntries,
  [out] DEDUP_CONTAINER_EXTENT **ReadPlan
);

Paramètres

[in] NumberOfContainers

Nombre de chemins de conteneur dans le tableau ContainerPaths .

[in] ContainerPaths

Tableau de chemins d’accès aux fichiers conteneur qui doivent être lus pour restaurer le fichier spécifié dans l’appel IDedupBackupSupport ::RestoreFiles . Chaque élément est un chemin d’accès complet du répertoire racine du volume à un fichier conteneur.

[out] ReadPlanEntries

Pointeur vers une variable ULONG qui reçoit le nombre de structures DEDUP_CONTAINER_EXTENT dans le tableau vers lequel pointe le paramètre ReadPlan .

[out] ReadPlan

Pointeur vers une mémoire tampon qui reçoit un tableau de structures DEDUP_CONTAINER_EXTENT .

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 . Les valeurs de retour possibles sont les suivantes.

Remarques

Étant donné une liste de fichiers conteneur qui contiennent des données pour le fichier cible de restauration, l’application génère éventuellement une liste d’étendues de fichiers de magasin de conteneurs dans un ordre trié qui aboutit à un plan de lecture entre conteneurs efficace. Pour un magasin de sauvegarde situé sur bande, cela est normalement dans l’ordre des bandes.

Dans le cas où un conteneur est stocké dans plusieurs extensions dans le magasin de sauvegarde( par exemple, à la suite d’une séquence de sauvegarde incrémentielle), l’application peut également retourner plusieurs extensions de conteneur pour chaque fichier conteneur logique.

L’application peut retourner des paramètres de sortie S_OK et NULL pour ignorer les optimisations du plan de lecture. Dans ce cas, l’ordre de lecture du conteneur est choisi par la déduplication des données.

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_CONTAINER_EXTENT

IDedupReadFileCallback