Compartilhar via

IEnumUnknown

  • Artigo

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This enumerator enumerates objects with the IUnknown interface. It can be used to enumerate through the objects in a component containing multiple objects. IEnumUnknown has the same methods as all enumerator interfaces: Next, Skip, Reset, and Clone.

When to Implement

You can implement this whenever you want a caller to be able to enumerate the objects contained in another object. You get a pointer to IEnumUnknown through a call to IOleContainer::EnumObjects.

When to Implement

Call the methods of IEnumUnknown to enumerate the objects in a compound document, when you get a pointer to the interface on the enumerator through a call to IOleContainer::EnumObjects.

Methods

The prototypes of the methods are as follows.

HRESULT Next(
  ULONG celt, 
  IUnknown** rgelt, 
  ULONG* pceltFetched 
);
HRESULT Skip(
  ULONG celt  
);
HRESULT Reset(void)
HRESULT Clone(
  IEnumUnknown** ppenum
);

Remarks

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header objidl.h, objidl.idl
Library ole32.lib, uuid.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later