Функция DismMountImage

Статья
06/19/2023

Подключает файл образа WIM или VHD к указанному расположению.

Синтаксис

HRESULT WINAPI DismMountImage(
  _In_     PCWSTR                 ImageFilePath,
  _In_     PCWSTR                 MountPath,
  _In_     UINT                   ImageIndex,
  _In_opt_ PCWSTR                 ImageName,
  _In_     DismImageIdentifier    ImageIdentifier,
  _In_     DWORD                  Flags,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData
);

Параметры

ImageFilePath [in]
Путь к WIM- или VHD-файлу на локальном компьютере. Требуется расширение .wim, .vhd или .vhdx.

MountPath [in]
Путь к расположению, в котором должен быть подключен образ. Этот путь подключения уже должен существовать на компьютере. Образ Windows в WIM-файле, VHD-файле или VHDX-файле можно подключить к пустой папке на диске в формате NTFS. Образ Windows в VHD- или VHDX-файле также можно подключить к неназначаемой букве диска. Невозможно подключить образ к корню существующего диска.

ImageIndex [in]
Индекс образа в WIM-файле, который требуется подключить. Для VHD-файла необходимо указать индекс 1.

ImageName [in, необязательный]
Необязательный элемент. Имя образа, который требуется подключить.

ImageIdentifier [in]
Значение перечисления DismImageIdentifier , например DismImageIndex.

Флаги [в]
Флаги подключения, используемые для этой операции. Дополнительные сведения о флагах подключения см. в разделе Константы API DISM.

CancelEvent [in, необязательный]
Необязательный элемент. Вы можете задать cancelEvent для этой функции, чтобы отменить выполняемую операцию по сигналу клиента. Если cancelEvent получено на этапе, когда операция не может быть отменена, операция продолжится и вернет код успешного выполнения. Если cancelEvent получено и операция отменена, состояние образа неизвестно. Перед продолжением необходимо проверить состояние образа или отменить изменения и начать снова.

Ход выполнения [in, необязательный]
Необязательный элемент. Указатель на определяемую клиентом функцию DismProgressCallback .

UserData [in, необязательный]
Необязательный элемент. Особые пользовательские данные.

Возвращаемое значение

Возвращает S_OK при успешном выполнении.

Возвращает E_INVALIDARG , если какой-либо из путей не имеет правильного формата или если MountPath или ImageFilePath не существует или является недопустимым.

Возвращает код ошибки Win32, сопоставленный с HRESULT для других ошибок.

MountPath должен быть путем к файлу, который уже существует на компьютере. Образы в WIM-файлах и VHD-файлах можно подключить к пустой папке на диске в формате NTFS. Вы также можете подключить образ из VHD-файла к неназначаемой букве диска. Невозможно подключить образ к корню существующего диска.

При подключении образа в WIM-файле его можно определить по номеру индекса изображения, указанному в ImageIndex, или по имени образа, указанному в параметре ImageName. ImageIdentifier указывает, следует ли использовать параметр ImageIndex или ImageName для идентификации изображения.

Пример

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

Требования

Требование	Описание
Поддерживаемые платформы узлов для WIM-файлов	API DISM можно использовать в любой операционной системе, поддерживаемой комплектом средств для развертывания и оценки Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике по Windows ADK.
Поддерживаемые платформы узлов для VHD- и VHDX-файлов	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

См. также раздел

DismUnmountImage

DismOpenSession

Поделиться через