Функция DismCheckImageHealth

Проверяет, можно ли обслуживать образ или он поврежден.

Синтаксис

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
);

Параметры

Сеанс [вход]
Допустимое DismSession. DismSession должен быть связан с изображением. Сеанс можно связать с изображением с помощью DismOpenSession.

ScanImage [вход]
Логическое значение, указывающее, следует ли сканировать изображение или просто проверка на наличие флагов из предыдущей проверки.

CancelEvent [in, необязательный]
Необязательный элемент. Вы можете задать cancelEvent для этой функции, чтобы отменить выполняемую операцию по сигналу клиента. Если cancelEvent получено на этапе, когда операция не может быть отменена, операция продолжится и вернет код успешного выполнения. Если cancelEvent получено и операция отменена, состояние образа неизвестно. Перед продолжением необходимо проверить состояние образа или отменить изменения и начать снова.

Ход выполнения [in, необязательный]
Необязательный элемент. Указатель на определяемый клиентом DismProgressCallback.

UserData [in, необязательный]
Необязательный элемент. Особые пользовательские данные.

ImageHealth [out]
Указатель на перечисление DismImageHealthState . Значение перечисления задается во время этой операции.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK .

Комментарии

Если параметр ScanImage имеет значение True, выполнение этой функции займет больше времени.

Пример

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

Требования

См. также раздел

DismRestoreImageHealth

DismImageHealthState

Константы API DISM