Edit

Share via

IEnumIDList interface (shobjidl_core.h)

  • Article

Exposes a standard set of methods used to enumerate the pointers to item identifier lists (PIDLs) of the items in a Shell folder. When a folder's IShellFolder::EnumObjects method is called, it creates an enumeration object and passes a pointer to the object's IEnumIDList interface back to the calling application.

Inheritance

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

Methods

The IEnumIDList interface has these methods.

 
IEnumIDList::Clone

Creates a new item enumeration object with the same contents and state as the current one. (IEnumIDList.Clone)
IEnumIDList::Next

Retrieves the specified number of item identifiers in the enumeration sequence and advances the current position by the number of items retrieved.
IEnumIDList::Reset

Returns to the beginning of the enumeration sequence.
IEnumIDList::Skip

Skips the specified number of elements in the enumeration sequence.

Remarks

All Shell folder objects must be able to respond to a call to their IShellFolder::EnumObjects method by creating an enumeration object that exports IEnumIDList. The Shell, in particular, uses these objects to enumerate the items in a folder.

Use this interface to enumerate the contents of a Shell folder object. Call the folder's IShellFolder::EnumObjects method and use the returned IEnumIDList pointer to enumerate the PIDLs of the items in the folder.

Requirements

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