Edit

Share via

IEnumerableView interface (shobjidl.h)

  • Article

Exposes methods that enumerate the contents of a view and receive notification from callback upon enumeration completion. This interface enables clients of a view to attempt to share the view's list of folder contents.

Inheritance

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

Methods

The IEnumerableView interface has these methods.

 
IEnumerableView::CreateEnumIDListFromContents

Creates an enumerator of ID lists from the contents of the view.
IEnumerableView::SetEnumReadyCallback

Sets a callback on the view that is notified when the initial view enumeration is complete.

Remarks

IFolderView (a folder view) supports presentation of the contents of a folder, and exposes the IEnumerableView through QueryService on service request SID_EnumerableView. IEnumerableView offers enhanced performance compared to obtaining the contents of the folder directly from the folder using IEnumIDList (call IShellFolder::EnumObjects to return this interface). Since the view asked for the contents of the folder in order to display those contents, using IEnumerableView enables a client to get a copy of the work already done by IFolderView.

Typically, this enumeration service is compatible with most folders, and is only provided if it is safe to enumerate the contents of the view. For example, using this service with a folder containing search results is not supported.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl.h