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


Функция DismRemoveCapability

Добавляет функцию в изображение.

Синтаксис

HRESULT WINAPI DismRemoveCapability(
  _In_     DismSession             Session,
  _In_     PCWSTR                  Name,
  _In_opt_ HANDLE                  CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK  Progress,
  _In_opt_ PVOID                   UserData
);

Параметры

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

имя [in]
Имя удаленной возможности

CancelEvent [ввод, необязательный]
Это дескриптор для отмены события.

Прогресс [опционально, в]
Указатель на определяемую клиентом функцию обратного вызова для отчета о ходе выполнения.

UserData [in, необязательный]
Определяемые пользователем пользовательские данные. Это будет передано пользователю через обратный вызов.

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

Если функция выполнена успешно, возвращаемое значение S_OK. Функция также может возвращать одно из следующих значений при успешном выполнении:

Возвращаемый код Описание
(HRESULT)ОШИБКА_УСПЕХ_ТРЕБУЕТСЯ_ПЕРЕЗАГРУЗКА
Если сеанс находится в сети, необходимо перезапустить компьютер.
DISMAPI_S_RELOAD_IMAGE_SESSION_REQUIRED
Необходимо перезагрузить сеанс.

Если функция завершается ошибкой, возвращаемое значение является значением ошибки HRESULT.

Замечания

Используйте эту функцию для удаления возможности.

Пример

HRESULT hr = S_OK;
hr = DismRemoveCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, NULL, NULL, NULL);

Требования

Требование Описание
Поддерживаемые хост-платформы API DISM можно использовать в любой операционной системе, поддерживаемой пакетом средств оценки и развертывания Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике Windows ADK.
Поддерживаемые платформы изображений Windows 10, Windows Server 2016
Минимальный поддерживаемый клиент Windows 10 [только настольные приложения]
Минимальный поддерживаемый сервер Windows Server 2016 [только настольные приложения]
Заголовок DismAPI.h
Библиотека DismAPI.lib
ДЛЛ DismAPI.dll

См. также

DismAddDriver

DismEnableFeature

DismGetPackages

DismGetPackageInfo

DismRemovePackage

DismPackage

DismPackageInfo

DismPackageFeatureState