Функция DismDisableFeature

Статья
12/19/2024

Отключает функцию в текущем изображении.

Синтаксис

HRESULT WINAPI DismDisableFeature(
  _In_     DismSession            Session,
  _In_     PCWSTR                 FeatureName,
  _In_opt_ PCWSTR                 PackageName,
  _In_     BOOL                   RemovePayload,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData
);

Параметры

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

FeatureName [вх.]
Имя функции, которую требуется отключить. Чтобы отключить несколько функций, разделите каждое имя функции точкой с запятой.

Имя пакета [необязательно]
Необязательный. Имя родительского пакета, в который входит функция. Если пакет не указан, используется пакет Windows Foundation по умолчанию.

RemovePayload [in]
Этот параметр не поддерживается начиная сWindows 8.1 и Windows Server 2012 R2.

Windows 8 и Windows Server 2012:

Логическое значение, указывающее, следует ли удалять файлы, необходимые для включения функции.

Ценность	Описание
ИСТИНА	Файлы удаляются.
ЛОЖЬ	Файлы не удаляются.

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

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

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

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

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

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

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

Пример

HRESULT hr = S_OK;
hr = DismDisableFeature(Session, "WindowsMediaPlayer", NULL, FALSE, 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

См. также

DismEnableFeature

DismGetFeatures

DismGetFeatureInfo

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