IFolderFilterSite interface

Exported by a host to allow clients to specify how to filter a Shell folder enumeration.

Members

The IFolderFilterSite interface inherits from the IUnknown interface. IFolderFilterSite also has these types of members:

Methods

The IFolderFilterSite interface has these methods.

MethodDescription
SetFilter

Exposed by a host to allow clients to pass the host their IUnknown interface pointers.

 

Remarks

The most common use of this interface is when your application calls SHBrowseForFolder. When you call this function, you become a client of the folder browser object. That object communicates with you by sending messages to a callback function, BrowseCallbackProc. The BFFM_IUNKNOWN message contains a pointer to the folder browser's IUnknown interface. To filter folder enumeration:

  1. Use the IUnknown pointer to call the folder browser's QueryInterface method, and request a pointer to the IFolderFilterSite interface.
  2. Call IFolderFilterSite::SetFilter, and pass the folder browser a pointer to your IFolderFilter (IUnknown or IFilterFolder?) interface.
  3. The folder browser will then query the two methods of the IFolderFilterSite interface to determine how to filter the enumeration.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

DLL

Shell32.dll

 

 

Show: