IOleContainer

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IOleItemContainer
IParseDisplayName
OLE Interfaces