IFolderFilterSite：：SetFilter 方法 (shobjidl_core.h)

  • 项目

由主机公开以允许客户端传递其 IUnknown 接口指针的主机。

语法

HRESULT SetFilter(
  [in] IUnknown *punk
);

参数

[in] punk

类型： IUnknown*

指向客户端的 IUnknown 接口的指针。 若要通知主机终止筛选并停止调用 IFolderFilter 接口，请将此参数设置为 NULL。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

获取指向主机 IFolderFilterSite 接口的指针后，调用此方法向主机传递指向 IUnknown 接口的指针。 然后，主机将使用此指针调用 QueryInterface 方法，以请求指向 IFolderFilter 接口的 指针。 如果此调用失败， IFolderFilterSite：：SetFilter 将返回 E_NOINTERFACEAVAILABLE。 如果调用成功，主机将调用 IFolderFilter 接口的两种方法，以确定如何枚举文件夹的内容。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll