Функция DismRemovePackage

Статья
06/20/2023

Удаляет пакет из образа.

Синтаксис

HRESULT WINAPI DismRemovePackage(
  _In_     DismSession            Session,
  _In_     PCWSTR                 Identifier,
  _In_     DismPackageIdentifier  PackageIdentifier,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData
);

Параметры

Сеанс [in]
Допустимое DismSession. DismSession должен быть связан с изображением. Сеанс можно связать с изображением с помощью DismOpenSession.

Идентификатор [in]
Абсолютный путь к файлу .cab или имя пакета в зависимости от значения параметра PackageIdentifier .

PackageIdentifier [in]
Необязательный элемент. Допустимое значение перечисления DismPackageIdentifier .

Значение	Описание
PackageName	Используйте это значение, если требуется указать пакет с помощью имени пакета.
PackagePath	Используйте это значение, если требуется указать пакет, используя абсолютный путь к файлу .cab.
PackageNone	Недопустимое значение для этой функции.

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

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

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

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

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

Пример

HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, NULL, NULL, NULL);

Требования

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

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

DismAddPackage

DismGetPackages

DismRemoveDriver

DismDisableFeature

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