Index   Commented   Search   About

IOleContainer::EnumObjects

Enumerates objects in the current container.

HRESULT EnumObjects(

DWORD grfFlags,
//Value specifying what is to be enumerated
IEnumUnknown **ppenum
//Ptr to storage of enumeration
);

Parameters

grfFlags

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

ppenum

[out] Points to an address where the enumerator, of type IEnumUnknown, should be returned. If an error is returned, this parameter must be set to NULL. Each time a container receives a 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.

Return Values

S_OK

Enumerator successfully returned.

E_FAIL

An unspecified error occurred.

E_NOTIMPL

Object enumeration not supported.

Comments

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.

See Also

IEnumUnknown, IOleItemContainer, OLECONTF

Related Links

Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET

More Online Helps

Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun