IEnumerableView interface (shobjidl.h)

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