filterUnload 函数 (fltuser.h)

项目
02/26/2024

通过调用 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) 中介绍了 (特权。)