WDEnable 函数 (windowsdefender.h)

将Windows Defender状态更改为“打开”或“关闭”。

注意  

自 Windows 10 版本 1607 起,WDEnable 不再可供使用。

从 Windows 10 版本 1607 和 Windows Server 2016 开始,WDEnable 函数始终返回E_NOTIMPL

 

语法

HRESULT WDEnable(
  [in] BOOL fEnable
);

参数

[in] fEnable

类型: BOOL

Windows Defender调用应用程序想要设置的状态。 TRUE 启用Windows Defender。 FALSE 禁用Windows Defender。

返回值

类型: HRESULT

此函数可以返回其中一个值。

返回代码 说明
S_OK
Windows Defender配置为所请求的状态。
E_ACCESSDENIED
调用应用程序没有足够的权限或被Windows Defender签名数据库标记为威胁。

无法通过数字签名验证调用应用程序标识。

HRESULT_FROM_WIN32(ERROR_ACCESS_DISABLED_BY_POLICY)
调用应用程序请求与组策略设置的Windows Defender状态相矛盾。
E_NOTIMPL
未实现。

注解

调用此函数的应用程序必须在本地计算机上使用管理员权限运行。 Windows Defender还会验证 (1) 调用进程和所有加载的模块的正确签名, (2) 在调用进程和所有加载的模块上设置IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY标志,然后再允许调用应用程序更改状态。 如果调用进程映像 (或) 的任何加载模块未签名或被Windows Defender签名标记为威胁,则调用失败并显示相应的错误代码。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 windowsdefender.h
DLL MpClient.dll

另请参阅

WDStatus