FilterUnload 函式 (fltuser.h)
已藉由呼叫 FilterLoad 載入支援迷你篩選的應用程式,可以藉由呼叫 FilterUnload 函式來卸除迷你篩選。
語法
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
參數
[in] lpFilterName
Null 終止寬字元字串的指標,其中包含傳遞至 FilterLoad 的相同迷你篩選名稱。 這是必要參數,不能是 NULL 或空字串。
傳回值
如果成功,FilterUnload 會傳回S_OK。 否則,它會傳回錯誤值。
備註
FilterUnload 是 與 FltUnloadFilter 相等的 Win32。
FilterUnload 會搜尋服務名稱符合指定 lpFilterName 的已註冊迷你篩選器,並呼叫 minifilter 的 FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) 例程。
如果迷你篩選器未註冊 FilterUnloadCallback 例程, 則 FilterUnload 的呼叫會失敗。
FilterUnload 的呼叫端必須具有 SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE) 的 LUID,才能載入或卸除迷你篩選驅動程式。 此許可權是由SE_LOAD_DRIVER_NAME名稱常數命名。 (許可權說明於適用於 Windows 7 的 Microsoft Windows 軟體開發工具包 (SDK) 和 .NET Framework 4.0 檔.)
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | fltuser.h (包含 Fltuser.h) |
程式庫 | FltLib.lib |
Dll | FltLib.dll |