通过

FilterDetach 函数 (fltuser.h)

  • 项目

FilterDetach 函数将给定的微筛选器实例与给定卷分离。

语法

HRESULT FilterDetach(
  [in]           LPCWSTR lpFilterName,
  [in]           LPCWSTR lpVolumeName,
  [in, optional] LPCWSTR lpInstanceName
);

参数

[in] lpFilterName

指向以 null 结尾的宽字符字符串的指针，该字符串包含要从堆栈中分离其实例的微筛选器的名称。 此参数是必需的，不能为 NULL。

[in] lpVolumeName

指向以 null 结尾的宽字符字符串的指针，该字符串包含实例当前附加到的卷的名称。

lpVolumeName 输入字符串可以是以下任一项。 尾随反斜杠 (\) 是可选的。

  • 驱动器号，例如“D：\”
  • 卷装入点的路径，例如“c：\mnt\edrive\”
  • 唯一卷标识符 (也称为 卷 GUID 名称) ，例如“\？？\Volume{7603f260-142a-11d4-ac67-806d6172696f}\”
  • 非持久性设备名称 (也称为 目标名称 或 NT 设备名称) ，例如“\Device\HarddiskVolume1\”
此参数是必需的，不能为 NULL。

[in, optional] lpInstanceName

指向以 null 结尾的宽字符字符串的指针，该字符串包含要删除的实例的实例名称。 此参数是可选的，可以为 NULL。 如果为 NULL，则删除匹配最高的实例。

返回值

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

备注

FilterDetach 是 Win32 等效于 FltDetachVolume。

FilterDetach 将微型筛选器实例从卷中分离并拆解该实例。

若要将微筛选器实例附加到卷，请调用 FilterAttach 或 FilterAttachAtAltitude。

要求

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

请参阅

FilterAttach

FilterAttachAtAltitude

FltDetachVolume