DismCommitImage 函数
提交对已装载的 .wim 或 .vhd 文件中的 Windows 映像所做的更改。 必须使用 DismMountImage 装载映像。
语法
HRESULT WINAPI DismCommitImage(
_In_ DismSession Session,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
参数
Session [in]
一个有效的 DismSession。 DismSession 必须关联一个映像。 可以使用 DismOpenSession 将会话与映像关联。
Flags [in]
要用于此操作的提交标志。 有关装载标志的详细信息，请参阅 DISM API 常量。
CancelEvent [in, optional]
要用于此操作的提交标志。 有关装载标志的详细信息，请参阅 DISM API 常量。
Progress [in, optional]
可选。 指向客户端定义的 DismProgressCallback 的指针。
UserData [in，可选]
可选。 用户定义的自定义数据。
返回值
成功时返回 S_OK 。
如果 DismSession 无效或 DismSession 未与已装载映像关联，则返回 E_INVALIDARG。
注解
DismCommitImage 函数不卸载映像。
注意
DismCommitImage 只能用于在 DISM 基础结构中装载的映像。 它不适用于使用其他工具（例如 DiskPart 工具）装载的映像，这些映像使用 DismOpenSession 提供服务。 必须使用 DismMountImage 在 DISM 基础结构内装载映像。
示例
HRESULT hr = S_OK;
hr = DismCommitImage(Session, 0, NULL, NULL, NULL);
要求
| 要求 | 说明 |
|---|---|
| 支持的主机平台 | DISM API 可在 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 |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |