Функция DismCommitImage
Фиксирует изменения, внесенные в образ Windows в подключенном WIM-файле или VHD-файле. Образ должен быть подключен с помощью DismMountImage.
Синтаксис
HRESULT WINAPI DismCommitImage(
_In_ DismSession Session,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Параметры
Сеанс [in]
Допустимое DismSession. DismSession должен быть связан с изображением. Сеанс можно связать с изображением с помощью DismOpenSession.
Флаги [in]
Флаги фиксации, используемые для этой операции. Дополнительные сведения о флагах подключения см. в разделе Константы API DISM.
CancelEvent [in, необязательно]
Флаги фиксации, используемые для этой операции. Дополнительные сведения о флагах подключения см. в разделе Константы API DISM.
Ход выполнения [в, необязательно]
Необязательный элемент. Указатель на определяемый клиентом DismProgressCallback.
UserData [in, optional]
Необязательный элемент. Особые пользовательские данные.
Возвращаемое значение
В случае успешного выполнения возвращает S_OK .
Возвращает значение E_INVALIDARG , если DismSession является недопустимым или DismSession не связан с подключенным образом.
Комментарии
Функция DismCommitImage не отключит изображение.
Примечание
DismCommitImage можно использовать только для образа, подключенного в инфраструктуре DISM. Он не применяется к образам, подключенным с помощью другого средства, например DiskPart, которые обслуживаются с помощью DismOpenSession. Для подключения образа в инфраструктуре DISM необходимо использовать DismMountImage .
Пример
HRESULT hr = S_OK;
hr = DismCommitImage(Session, 0, NULL, NULL, NULL);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемые платформы узлов | API DISM можно использовать в любой операционной системе, поддерживаемой пакетом средств оценки и развертывания Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике по Windows ADK. |
| Поддерживаемые платформы образов | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, среда предустановки Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10 Windows Server 2016 |
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Заголовок | DismAPI.h |
| Библиотека | DismAPI.lib |
| DLL | DismAPI.dll |