Функция DismUnmountImage
[Некоторые сведения относятся к предварительно выпущенным продуктам, которые могут быть существенно изменены до его коммерческого выпуска. Майкрософт не дает никаких гарантий, явных или подразумеваемых, в отношении предоставленной здесь информации.]
Отключает образ 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]
Флаги отключения, используемые для этой операции. Дополнительные сведения о флагах отключения см. в разделе Константы API DISM.
CancelEvent [in, необязательно]
Необязательный элемент. Вы можете задать CancelEvent для этой функции, чтобы отменить выполняемую операцию при получении от клиента сигнала. Если cancelEvent получено на этапе, когда операция не может быть отменена, операция продолжится и вернет код успешного выполнения. Если cancelEvent получено и операция отменена, состояние образа неизвестно. Перед продолжением необходимо проверить состояние образа или отменить изменения и начать снова.
Ход выполнения [в, необязательно]
Необязательный элемент. Указатель на определяемый клиентом 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 | API DISM можно использовать в любой операционной системе, поддерживаемой пакетом средств оценки и развертывания 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 |