Expand Minimize

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.

MethodDescription
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

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IEnumMoniker is defined as 00000102-0000-0000-C000-000000000046

See also

IMoniker::Enum
IRunningObjectTable::EnumRunning

 

 

Community Additions

ADD
Show:
© 2014 Microsoft