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
);
參數
會話 [in]
有效的 DismSession。 DismSession 必須與映射相關聯。 您可以使用 DismOpenSession將會話與映射產生關聯。
旗標 [in]
要用於此作業的認可旗標。 如需掛接旗標的詳細資訊，請參閱 DISM API 常數。
CancelEvent [in， optional]
要用於此作業的認可旗標。 如需掛接旗標的詳細資訊，請參閱 DISM API 常數。
進度 [in， 選擇性]
選擇性。 用戶端定義 DismProgressCallback的指標。
UserData [in， optional]
選擇性。 使用者定義的自訂資料。
傳回值
成功時會傳回 S_OK 。
E_INVALIDARG如果DismSession無效，或 DismSession 未與掛接的映射相關聯，則傳回 。
備註
DismCommitImage函式不會取消掛接映射。
注意
DismCommitImage 只能在 DISM 基礎結構內掛接的映射上使用。 它不適用於另一個工具所掛接的映射，例如使用 DismOpenSession提供服務的 DiskPart 工具。 您必須使用 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 |
| 程式庫 | DismAPI.lib |
| DLL | DismAPI.dll |