filterInstanceCreate 函数 (fltuser.h)
FilterInstanceCreate 函数创建一个句柄,该句柄可用于与给定的微筛选器实例进行通信。
语法
HRESULT FilterInstanceCreate(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[out] HFILTER_INSTANCE *hInstance
);
参数
[in] lpFilterName
指向以 null 结尾的宽字符字符串的指针,该字符串包含拥有实例的微筛选器的名称。
[in] lpVolumeName
指向以 null 结尾的宽字符字符串的指针,该字符串包含实例所附加到的卷的名称。
lpVolumeName 输入字符串可以是以下任一项。 尾随反斜杠 (\) 是可选的。
- 驱动器号,例如“D:\”
- 卷装入点的路径,例如“c:\mnt\edrive\”
- 唯一卷标识符 (也称为卷 GUID 名称) ,例如“\??\Volume{7603f260-142a-11d4-ac67-806d6172696f}\”
- 非永久性设备名称 (也称为 目标名称 或 NT 设备名称) ,例如“\Device\HarddiskVolume1\”
[in, optional] lpInstanceName
指向以 null 结尾的宽字符字符串的指针,该字符串包含实例的实例名称。 此参数是可选的,可以为 NULL。 如果为 NULL,则返回为此卷上的此微筛选器找到的第一个实例。
[out] hInstance
指向调用方分配的变量的指针,如果对 FilterInstanceCreate 的调用成功,该变量接收微筛选器实例的不透明句柄;否则,它将接收INVALID_HANDLE_VALUE。
返回值
如果成功,FilterInstanceCreate 将返回S_OK。 否则,它将返回错误值。
注解
用户模式应用程序调用 FilterInstanceCreate 来创建可用于与内核模式微筛选器实例通信的句柄。 返回的实例句柄可以作为参数传递给 FilterInstanceGetInformation 等函数。
若要关闭 FilterInstanceCreate 返回的实例句柄,请调用 FilterInstanceClose。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | fltuser.h (包括 Fltuser.h) |
Library | FltLib.lib |
DLL | FltLib.dll |