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 |