DismUnmountImage 函式
[某些資訊與發行前發行的產品有關，在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。]
從指定的位置卸載 Windows 映像。
語法
HRESULT WINAPI DismUnmountImage(
_In_ PCWSTR MountPath,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
參數
MountPath [in]
映射掛接目錄的相對或絕對路徑。
旗標 [in]
要用於此作業的卸載旗標。 如需卸載旗標的詳細資訊，請參閱 DISM API 常數。
CancelEvent [in， optional]
選擇性。 您可以設定此函式的 CancelEvent ，以便在用戶端發出訊號時取消進行中的作業。 如果在無法取消作業的階段收到 CancelEvent ，作業將會繼續並傳回成功碼。 如果收到 CancelEvent 且作業已取消，映射狀態為未知。 您應該先確認映射狀態，再繼續或捨棄變更，然後再開始一次。
進度 [in， 選擇性]
選擇性。 用戶端定義 DismProgressCallback的指標。
UserData [in， optional]
選擇性。 使用者定義的自訂資料。
傳回值
傳回成功 時S_OK 。
備註
使用 DismCloseSession 結束每個使用中的 DismSession之後，您可以使用 DismUnmountImage 函式將映射取消掛接。
範例
HRESULT hr = S_OK;
hr = DismMountImage(L"C:\\test\\images\\myimage.wim", L"C:\\test\\offline", 1,
NULL, DismImageIndex, DISM_MOUNT_READWRITE, NULL, NULL, NULL);
hr = DismUnmountImage (L"C:\\test\\offline", DISM_COMMIT_IMAGE, NULL, NULL, NULL);
規格需求
| 需求 | 描述 |
|---|---|
| WIM 映射支援的主機平臺 | DISM API 可用於 Windows 評定與部署套件所支援的任何作業系統， (Windows ADK) 。 如需詳細資訊，請參閱 Windows ADK 技術參考 |
| VHD 映射支援的主機平臺 | 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 |