FilterCreate 函数 (fltuser.h)

  • 项目

FilterCreate 函数为给定的微筛选器创建句柄。

语法

HRESULT FilterCreate(
  [in]  LPCWSTR lpFilterName,
  [out] HFILTER *hFilter
);

参数

[in] lpFilterName

指向以 null 结尾的宽字符字符串的指针，该字符串包含微筛选器的名称。 此参数是必需的，不能为 NULL。

[out] hFilter

指向调用方分配的变量的指针，如果对 FilterCreate 的调用成功，该变量接收微筛选器的句柄;否则，它将接收INVALID_HANDLE_VALUE。

返回值

如果成功，FilterCreate 将返回S_OK。 否则，它将返回错误值。

备注

用户模式应用程序调用 FilterCreate 来创建可用于与内核模式微筛选器通信的句柄。 返回的微筛选器句柄可以作为参数传递给 FilterGetInformation 等函数。

若要关闭 FilterCreate 返回的筛选器句柄，请调用 FilterClose。

要求

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

请参阅

FilterClose

FilterGetInformation