IEnumMoniker interface
Enumerates the components of a moniker or the monikers in a table of monikers.
When to implement
You need to implement IEnumMoniker if you are writing a new type of moniker and your monikers have an internal structure that can be enumerated. Your implementation of IMoniker::Enum must return an enumerator that implements IEnumMoniker and can enumerate your moniker's components. If your moniker has no structure that can be enumerated, your IMoniker::Enum method can simply return a NULL pointer.
When to use
Call the methods of the IEnumMoniker interface if you need to enumerate the components of a composite moniker, or to enumerate the monikers in a table.
OLE defines two interfaces that provide an IEnumMoniker interface pointer:
- The IMoniker::Enum method gets a pointer to an IEnumMoniker implementation that can enumerate forwards or backwards through the components of the moniker. For a description of how the system-supplied types of monikers enumerate their components, see IMoniker.
- The IRunningObjectTable::EnumRunning method returns a pointer to an IEnumMoniker implementation that can enumerate the monikers registered in a running object table (ROT).
Members
The IEnumMoniker interface inherits from the IUnknown interface. IEnumMoniker also has these types of members:
Methods
The IEnumMoniker interface has these methods.
| Method | Description |
|---|---|
| Clone |
Creates a new enumerator that contains the same enumeration state as the current one. |
| Next |
Retrieves the specified number of items in the enumeration sequence. |
| Reset |
Resets the enumeration sequence to the beginning. |
| Skip |
Skips over the specified number of items in the enumeration sequence. |
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps | Windows Store apps] |
|
Header |
|
|
IDL |
|
|
IID |
IID_IEnumMoniker is defined as 00000102-0000-0000-C000-000000000046 |
See also