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:
- Use the IUnknown pointer to call the folder browser's QueryInterface method, and request a pointer to the IFolderFilterSite interface.
- Call IFolderFilterSite::SetFilter, and pass the folder browser a pointer to your IFolderFilter (IUnknown or IFilterFolder?) interface.
- 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) |