Использование API DISM
API обслуживания образов развертывания и управления ими (DISM) позволяет создавать настраиваемые решения на платформе DISM. API DISM можно использовать для установки, удаления, настройки и обновления компонентов, пакетов и драйверов Windows в образе Windows. DISM можно использовать для управления образами Windows и их обслуживания в формате файлов образа Windows (WIM) или файлов виртуального жесткого диска (VHD, VHDX).
Требования
Для создания приложений API DISM необходимо установить комплект средств для развертывания и оценки Windows (Windows ADK) на компьютере разработки:
Ваши настраиваемые решения на платформе DISM разрабатываются с помощью пакета SDK для DISM. Устанавливается при установке Windows ADK. Дополнительные сведения о поддерживаемых операционных системах см. в техническом справочнике по комплекту средств для развертывания и оценки Windows (Windows ADK).
При запуске настраиваемых решений на платформе DISM необходимо убедиться, что версия архитектуры Windows ADK соответствует версии архитектуры операционной системы. Например, настраиваемое решение, разработанное для 32-разрядных компьютеров, работает в 32-разрядной версии Windows.
Для правильной разработки и запуска настраиваемых решений на платформе DISM необходимо убедиться, что вы используете двоичные файлы DISM из Windows ADK:
Установите последнюю версию Windows ADK на компьютере, где будет выполняться настроенное решение.
Двоичные файлы для настроенных решений должны быть сохранены в том же каталоге, что и двоичные файлы DISM, установленные Windows ADK. Например, двоичные файлы настраиваемых решений должны находиться в папке c:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\DISM.
Запустите настроенные решения из среды средств развертывания и создания образов , чтобы перед запуском решений были настроены необходимые переменные среды.
На начальном экране введите deployment. Щелкните правой кнопкой мыши Среда средств развертывания и обработки образов и выберите Запуск от имени администратора.
Примечание Если вы не запускаете из среды средств развертывания и создания образов, необходимо убедиться, что переменная среды PATH использует расположение двоичных файлов DISM из Windows ADK.
Чтобы использовать DISMAPI для обслуживания и управления ими, потребуется поддерживаемый тип файла образа Windows, WIM, VHD или VHDX, а также оперативная установка Windows. Некоторые операции недопустимы для образов в Интернете. Дополнительные сведения см. в справочнике по API DISM.
Поддерживаемые целевые образы
Файл образа Windows, который вы обслуживаете на хост-компьютере, может быть WIM-файлом, VHD- или VHDX-файлом, а также сетевой установкой Windows. Кроме того, поддерживается межархитектурное обслуживание. Вы можете обслуживать образ x64 из системы x86 или x64. Вы можете обслуживать образ x86 из системы x64 или x86.
Все функции DISMAPI можно выполнять на Windows 8 и Windows Server 2012 целевых образах. Чтобы узнать, можно ли выполнять функцию на других целевых образах, см. раздел Требования статьи справочника по функциям в справочнике по API DISM.
Рекомендации
Управление памятью Некоторые функции API DISM возвращают структуры или массивы структур. Эти структуры возвращаются пользователю в качестве указателя на объект в куче. Память кучи выделяется API DISM. Клиент должен вызвать функцию DismDelete , чтобы убедиться, что эта память освобождена.
Подключение виртуального жесткого диска с помощью средства DiskPart. По возможности следует использовать API DISM для подключения и отключения образов, которые необходимо обслуживать в рамках платформы DISM. Использование другого средства, например DiskPart, для подключения и отключения образа может привести к непредвиденным последствиям.
Пути к файлам. Все пути, принимаемые функциями API DISM, могут быть относительными или абсолютными. Рекомендуется ограничить длину путей к файлам. Слишком длинные пути к файлам или превышающие ограничение максимальной длины для Windows, вызовут сбои в DISM.
Соответствующие вызовы для открытия и закрытия сеансов. Всегда освобождайте сеанс DISM с помощью функции DismCloseSession перед вызовом функции DismShutdown. Вы также можете отключить образ с помощью функции DismUnmountImage после закрытия сеанса и перед вызовом функции DismShutdown.
Другие средства DISM
Дополнительные сведения о платформе DISM и других способах доступа к функциям обслуживания и управления см. в техническом справочнике по DISM в техническом справочнике по комплекту средств для развертывания и оценки Windows (Windows ADK). Вы также можете использовать средство DISM.exe в Windows ADK для записи изображения в виде WIM-файла.