IOleContainer::EnumObjects (Windows CE 5.0)

Send Feedback

Enumerates objects in the current container.

HRESULT EnumObjects(  DWORDgrfFlags,        //Value specifying what is to be enumerated
  IEnumUnknown**ppenum  //Address of output variable that receives the 
);                       // IEnumUnknown interface pointer

Parameters

  • grfFlags
    [in] Value that specifies which objects in a container are to be enumerated, as defined in the enumeration OLECONTF.
  • ppenum
    [out] Address of IEnumUnknown* pointer variable that receives the interface pointer to the enumerator object. Each time a container receives a successful call to EnumObjects, it must increase the reference count on the *ppenum pointer the method returns. It is the caller's responsibility to call IUnknown::Release when it is done with the pointer. If an error is returned, the implementation must set *ppenum to NULL.

Return Values

This method supports the standard return value E_FAIL, as well as the following:

Value Description
S_OK Enumerator successfully returned.
E_NOTIMPL Object enumeration not supported.

Remarks

A container should implement EnumObjects to enable programmatic clients to find out what objects it holds. This method, however, is not called in standard linking scenarios.

Requirements

OS Versions: Windows CE 4.0 and later.
Header: oleidl.h.

See Also

IEnumUnknown

IOleItemContainer

IOleContainer

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.