Fonction DismRestoreImageHealth

Répare une image endommagée qui a été identifiée comme réparable par DismCheckImageHealth.

Syntaxe

HRESULT WINAPI DismRestoreImageHealth(
  _In_     DismSession            Session,
  _In_opt_ PCWSTR                 *SourcePaths,
  _In_opt_ UINT                   SourcePathCount,
  _In_     BOOL                   LimitAccess,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData
);

Paramètres

Session [entrée]
Une DismSession valide. La DismSession doit être associée à une image. Vous pouvez associer une session à une image à l’aide de DismOpenSession.

SourcePaths [in, facultatif]
facultatif. Liste des emplacements sources à case activée pour les fichiers de réparation.

SourcePathCount [in, facultatif]
facultatif. Nombre d’emplacements sources spécifiés.

LimitAccess [in]
Valeur booléenne qui indique si la fonction DismRestoreImageHealth doit contacter Windows Update (WU) comme emplacement source pour télécharger les fichiers de réparation. Avant de vérifier WU, DISM case activée pour les fichiers dans les SourcesPaths fournis et dans tous les emplacements spécifiés dans le Registre par stratégie de groupe. Si les fichiers requis pour activer la fonctionnalité se trouvent dans ces autres emplacements spécifiés, cet indicateur est ignoré.

CancelEvent [entrée, facultatif]
Optionnel. Vous pouvez définir un CancelEvent pour cette fonction afin d’annuler l’opération en cours lorsqu’elle est signalée par le client. Si l’événement CancelEvent est reçu à un stade où l’opération ne peut pas être annulée, l’opération continue et retourne un code de réussite. Si l’événement CancelEvent est reçu et que l’opération est annulée, l’état de l’image est inconnu. Vous devez vérifier l’état de l’image avant de continuer ou d’ignorer les modifications et de recommencer.

Progress [entrée, facultatif]
Optionnel. Pointeur vers un DismProgressCallback défini par le client.

UserData [entrée, facultatif]
Optionnel. Données personnalisées définies par l’utilisateur.

Valeur retournée

Renvoie S_OK en cas de réussite.

Notes

Exécutez DismCheckImageHealth pour déterminer si l’image est endommagée et si l’image est réparable. Si DismCheckImageHealth renvoie DismImageRepairable, la fonction DismRestoreImageHealth peut réparer l’image.

Si un fichier de réparation n’est trouvé dans aucun des emplacements spécifiés par le paramètre SourcePaths ou dans les chemins d’accès d’emplacement dans le registre spécifié par stratégie de groupe, la fonction DismRestoreImageHealth contacte WU pour case activée pour un fichier de réparation, sauf si le paramètre LimitAccess est défini sur TRUE.

Exemple

HRESULT hr = S_OK;
hr = DismRestoreImageHealth(Session, NULL, 0, TRUE, NULL, NULL, NULL);

Spécifications

Voir aussi

DismCheckImageHealth

DismImageHealthState