通过

FilterLoad 函数 (fltuser.h)

  • 项目

FilterLoad 函数将微筛选器驱动程序动态加载到系统中。

语法

HRESULT FilterLoad(
  [in] LPCWSTR lpFilterName
);

参数

[in] lpFilterName

指向以 null 结尾的宽字符字符串的指针，该字符串指定微筛选器驱动程序的服务名称。 此参数是必需的，不能为 NULL 或空字符串。

返回值

如果成功，FilterLoad 将返回S_OK。 否则，它将返回以下错误值之一：

返回代码 说明
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)
微筛选器驱动程序已在运行。
HRESULT_FROM_WIN32 (ERROR_FILE_NOT_FOUND)
找不到匹配的微筛选器驱动程序。
HRESULT_FROM_WIN32 (ERROR_SERVICE_ALREADY_RUNNING)
微筛选器驱动程序已在运行。
HRESULT_FROM_WIN32 (ERROR_BAD_EXE_FORMAT)
lpFilterName 指定的微筛选器驱动程序的加载映像无效。
HRESULT_FROM_WIN32 (ERROR_BAD_DRIVER)
lpFilterName 指定的微筛选器驱动程序的加载映像无效。
HRESULT_FROM_WIN32 (ERROR_INVALID_IMAGE_HASH)
微筛选器驱动程序的数字签名无效。

备注

FilterLoad 是 Win32 等效于 FltLoadFilter。

依赖于内核模式微筛选器驱动程序的用户模式应用程序可以通过调用 FilterLoad 来加载微筛选器驱动程序。

FilterLoad 的调用方必须具有 SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE) 的 LUID 才能加载或卸载微筛选器驱动程序。 此权限由SE_LOAD_DRIVER_NAME名称常量命名。 适用于 Windows 7 和 .NET Framework 4.0 的 Microsoft Windows 软件开发工具包 (SDK) 中介绍了 (特权。)

若要卸载微筛选器驱动程序，请调用 FilterUnload。

要求

   
目标平台 通用
标头 fltuser.h (包括 Fltuser.h)
Library FltLib.lib
DLL FltLib.dll

请参阅

FilterUnload

FltLoadFilter

HRESULT_FROM_WIN32