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

另请参阅

FilterInstanceClose

FilterInstanceGetInformation