Функция 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 [вход]
Логическое значение, указывающее, следует ли сканировать изображение или просто проверка на наличие флагов из предыдущей проверки.
| Значение | Описание |
|---|---|
| TRUE | Отсканируйте изображение и пометите его, если оно повреждено. |
| Ложь. | Проверьте, помечено ли изображение как поврежденное. Это значение можно использовать, если изображение уже проверено. |
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);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемые платформы узлов | API DISM можно использовать в любой операционной системе, поддерживаемой комплектом средств для развертывания и оценки Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике по Windows ADK. |
| Поддерживаемые платформы образов | Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Заголовок | DismAPI.h |
| Библиотека | DismAPI.lib |
| DLL | DismAPI.dll |