IOleContainer::EnumObjects

Enumerates objects in the current container.

HRESULT EnumObjects(

DWORD grfFlags,

//Value specifying what is to be enumerated

IEnumUnknown **ppenum

//Indirect pointer to enumerator object

);

Parameters

grfFlags

[in] Value that specifies which objects in a container are to be enumerated, as defined in the enumeration OLECONTF.

ppenum

[out] When successful, indirect pointer to the IEnumUnknown interface on the enumerator object. Each time a container receives a successful call to EnumObjects, it must increase the reference count on the 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, this parameter must be set to NULL.

Return Values

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

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.

DWORD grfFlags,	//Value specifying what is to be enumerated
IEnumUnknown **ppenum	//Indirect pointer to enumerator object
);