IFolderFilterSite interface (shobjidl_core.h)

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

Inheritance

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

Methods

The IFolderFilterSite interface has these methods.

 
IFolderFilterSite::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

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)