Export (0) Print
Expand All

DismUnmountImage Function

Unmounts a Windows image from a specified location.

HRESULT WINAPI DismUnmountImage(
    _In_ PCWSTR MountPath,
    _In_ DWORD Flags,
    _In_opt_ HANDLE CancelEvent,
    _In_opt_ DISM_PROGRESS_CALLBACK Progress,
    _In_opt_ PVOID UserData



Parameter Name Description


A relative or absolute path to the mount directory of the image.


The unmount flags to use for this operation. For more information about unmount flags, see DISM API Constants.


Optional. You can set a CancelEvent for this function in order to cancel the operation in progress when signaled by the client. If the CancelEvent is received at a stage when the operation cannot be canceled, the operation will continue and return a success code. If the CancelEvent is received and the operation is canceled, the image state is unknown. You should verify the image state before continuing or discard the changes and start again.


Optional. A pointer to a client-defined DismProgressCallback Function.


Optional. User defined custom data.

Returns OK on success.

After you use the DismCloseSession Function to end every active DISMSession, you can unmount the image using the DismUnmountImage function.

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


Supported host platforms for WIM images:

DISM API can be used on any operating system supported by the Windows® Assessment and Deployment Kit (Windows ADK). For more information, see the Windows ADK Technical Reference.

Supported host platforms for VHD images:

Windows® 7, Windows Server® 2008 R2, Windows® 8, Windows Server® 2012

© 2015 Microsoft