IEnumIDList
The IEnumIDList
interface enumerates item identifiers associated with shell folder objects.
First, use IShellFolder::EnumObjects
IEnumIDList has the same methods as all enumerator interfaces: Next,
Skip, Reset, and Clone. Next iterates through the
item IDs one or more at a time, Skip passes over the next item ID in the
list, Reset returns to the beginning of the item ID list, and Clone
returns a duplicate item enumeration object.
When to Implement
You can
implement this interface when you want a caller to be able to enumerate the
item IDs contained in a folder object. You get a pointer to IEnumIDList
through IShellFolder::EnumObjects.
When to Use
You don t use
this interface directly. IShellFolder::EnumObjects creates an
enumeration object of this kind. In this case, the enumeration is a set of item
identifiers. The shell calls then IEnumIDList methods to enumerate the items contained in a
enumeration object.
Methods in Vtable Order
IUnknown
Methods |
Description |
QueryInterface |
Returns
pointers to supported interfaces. |
AddRef |
Increments
reference count. |
Release |
Decrements
reference count. |
IEnumIDList
Methods |
Description |
Next |
Retrieves
the specified number of item identifiers. |
Skip |
Skip over
the specified number of items. |
Reset |
Return to
the beginning of the enumeration. |
Clone |
Creates a
new item enumeration object identical to the current one. |