filterUnload 函数 (fltuser.h)
通过调用 FilterLoad 加载支持微筛选器的应用程序可以通过调用 FilterUnload 函数卸载微筛选器。
语法
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
参数
[in] lpFilterName
指向以 null 结尾的宽字符字符串的指针,该字符串包含传递给 FilterLoad 的同一微筛选器名称。 此参数是必需的,不能为 NULL 或空字符串。
返回值
如果成功,FilterUnload 将返回S_OK。 否则,它将返回错误值。
注解
FilterUnload 是 FltUnloadFilter 的 Win32 等效项。
FilterUnload 搜索其服务名称与给定 lpFilterName 匹配的已注册微筛选器,并调用该微筛选器的 FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) 例程。
如果微筛选器未注册 FilterUnloadCallback 例程,则对 FilterUnload 的调用将失败。
FilterUnload 的调用方必须具有 SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE) 的 LUID 才能加载或卸载微筛选器驱动程序。 此权限由SE_LOAD_DRIVER_NAME名称常量命名。 适用于 Windows 7 和 .NET Framework 4.0 的 Microsoft Windows 软件开发工具包 (SDK) 中介绍了 (特权。)
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | fltuser.h (包括 Fltuser.h) |
Library | FltLib.lib |
DLL | FltLib.dll |