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


Функция WDEnable (windowsdefender.h)

Изменяет состояние Защитник Windows на включено или выключено.

Примечание  

WDEnable больше недоступен для использования с Windows 10 версии 1607.

Начиная с Windows 10 версии 1607 и Windows Server 2016 функция WDEnable всегда возвращает E_NOTIMPL.

 

Синтаксис

HRESULT WDEnable(
  [in] BOOL fEnable
);

Параметры

[in] fEnable

Тип: BOOL

Защитник Windows состояние, которое требуется задать вызывающему приложению. Значение TRUE включает Защитник Windows. Значение FALSE отключает Защитник Windows.

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

Тип: HRESULT

Эта функция может возвращать одно из этих значений.

Код возврата Описание
S_OK
Защитник Windows настроено в соответствии с запрошенным состоянием.
E_ACCESSDENIED
Приложение для вызова не имеет достаточных разрешений или помечается как угроза Защитник Windows базе данных сигнатуры.

Вызов удостоверения приложения не проверяется с помощью цифровой подписи.

HRESULT_FROM_WIN32(ERROR_ACCESS_DISABLED_BY_POLICY)
Вызов запроса приложения противоречит состоянию Защитник Windows, заданному групповой политикой.
E_NOTIMPL
Не реализован.

Комментарии

Приложение, вызывающее эту функцию, должно выполняться с разрешениями администратора на локальном компьютере. Защитник Windows также проверяет (1) правильность подписывания вызывающего процесса и всех загруженных модулей и (2) устанавливает флаг IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY для вызывающего процесса и всех загруженных модулей, прежде чем разрешить вызывающему приложению изменить состояние. Если образ вызывающего процесса (или загруженные модули) не подписан или помечен как угроза сигнатурой Защитник Windows, вызов завершается ошибкой с соответствующим кодом ошибки.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header windowsdefender.h
DLL MpClient.dll

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

WDStatus