Функция DismRestoreImageHealth

Восстанавливает поврежденный образ, который был определен как доступный для восстановления с помощью DismCheckImageHealth.

Синтаксис

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

Параметры

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

SourcePaths [in, необязательный]
Необязательный элемент. Список исходных расположений для проверка файлов восстановления.

SourcePathCount [в, необязательно]
Необязательный элемент. Указанное количество исходных расположений.

LimitAccess [in]
Логическое значение, указывающее, должна ли функция DismRestoreImageHealth обращаться к клиентский компонент Центра обновления Windows (WU) в качестве исходного расположения для скачивания файлов восстановления. Перед проверкой WU DISM будет проверка для файлов в предоставленных SourcePaths и в любых расположениях, указанных в реестре групповая политика. Если файлы, необходимые для включения функции, находятся в других указанных расположениях, этот флаг игнорируется.

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

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

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

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

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

Комментарии

Запустите DismCheckImageHealth , чтобы определить, поврежден ли образ и доступен ли он для восстановления. Если DismCheckImageHealth возвращает DismImageRepairable, функция DismRestoreImageHealth может восстановить образ.

Если файл восстановления не найден ни в одном из расположений, указанных параметром SourcePaths, или в путях расположения в реестре, указанном в групповая политика, функция DismRestoreImageHealth свяжется с WU для проверка файла восстановления, если параметр LimitAccess не имеет значение TRUE.

Пример

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

Требования

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

DismCheckImageHealth

DismImageHealthState