Fonction DismCheckImageHealth

Vérifie si l’image peut être mise en service ou est endommagée.

Syntaxe

HRESULT WINAPI WINAPI DismCheckImageHealth(
  _In_     DismSession            Session,
  _In_     BOOL                   ScanImage,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData,
  _Out_    DismImageHealthState   *ImageHealth
);

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.

ScanImage [entrée]
Valeur booléenne qui spécifie s’il faut analyser l’image ou vérifier simplement les indicateurs d’une analyse précédente.

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.

ImageHealth [sortie]
Pointeur vers l’énumération DismImageHealthState. La valeur d’énumération est définie au cours de cette opération.

Valeur retournée

Retourne S_OK en cas de réussite.

Notes

Si ScanImage a la valeur True, cette fonction prendra plus de temps.

Exemple

HRESULT hr = S_OK;
DismImageHealthState state;
hr = DismCheckImageHealth(Session, TRUE, NULL, NULL, NULL, &state);

Spécifications

Voir aussi

DismRestoreImageHealth

DismImageHealthState

Constantes de l’API DISM