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
Send Feedback on this topic to the authors