Share via


IOleContainer (Compact 2013)

3/26/2014

The IOleContainer interface is used to enumerate objects in a compound document or lock a container in the running state. Container and object applications both implement this interface.

When to Implement

Applications that support links and links to embedded objects implement this interface to provide object enumeration, name parsing, and silent updates of link sources. Simple, non-linking containers do not need to implement IOleContainer if it is useful mainly to support links to embedded objects.

When to Use

Call IOleContainer to enumerate the objects in a compound document or to lock a container so that silent updates of link sources can occur without interruption until the container is explicitly released.

Many applications inherit the functions of IOleContainer by implementing IOleItemContainer, which is used to bind item monikers.

Methods in VTable Order

IUnknown method

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments the reference count.

Release

Decrements the reference count.

IParseDisplayName

Method Description

ParseDisplayName

Parses object's display name to form moniker.

IOleContainer Methods

Description

EnumObjects

Enumerates objects in a container.

LockContainer

Keeps container running until explicitly released.

Requirements

Header

Oleidl.h

See Also

Reference

OLE Interfaces
IOleItemContainer
IParseDisplayName