將 Windows Defender 狀態變更為開啟或關閉。
注意
WDEnable 已不再可供 Windows 10 版本 1607 使用。
從 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
此函式可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
Windows Defender 設定為所要求的狀態。 |
|
呼叫應用程式沒有足夠的許可權,或是由 Windows Defender 簽章資料庫標示為威脅。
呼叫應用程式身分識別無法透過數位簽名進行驗證。 |
|
呼叫應用程式要求與組策略所設定 Windows Defender 狀態衝突。 |
|
未實作。 |
備註
呼叫此函式的應用程式必須在本機計算機上以系統管理員許可權執行。 Windows Defender 也會驗證 (1) 呼叫程式的適當簽署,以及所有載入的模組,以及 (2) 呼叫進程和所有載入的模組,讓呼叫應用程式變更狀態之前,先設定IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY旗標。 如果呼叫進程映像 (或任何載入的模組) 未簽署或由 Windows Defender 簽章標示為威脅,則呼叫會失敗並顯示適當的錯誤碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | windowsdefender.h |
| Dll | MpClient.dll |