IOleLink interface

Enables a linked object to provide its container with functions pertaining to linking. The most important of these functions is binding to the link source, that is, activating the connection to the document that stores the linked object's native data. IOleLink also defines functions for managing information about the linked object, such as the location of the link source and the cached presentation data for the linked object.

A container application can distinguish between embedded objects and linked objects by querying for IOleLink; only linked objects implement IOleLink.


The IOleLink interface has these methods.

Method Description
IOleLink::BindIfRunning Activates the connection between the linked object and the link source if the link source is already running.
IOleLink::BindToSource Activates the connection to the link source by binding the moniker stored within the linked object.
IOleLink::GetBoundSource Retrieves a pointer to the link source if the connection is active.
IOleLink::GetSourceDisplayName Retrieves the display name of the link source of the linked object.
IOleLink::GetSourceMoniker Retrieves the moniker identifying the link source of a linked object.
IOleLink::GetUpdateOptions Retrieves a value indicating how often the linked object updates its cached data.
IOleLink::SetSourceDisplayName Sets the display name for the link source.
IOleLink::SetSourceMoniker Sets the moniker for the link source.
IOleLink::SetUpdateOptions Specifies how often a linked object should update its cached data.
IOleLink::UnbindSource Breaks the connection between a linked object and its link source.
IOleLink::Update Updates the compound document's cached data for a linked object. This involves binding to the link source, if it is not already bound.


Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header oleidl.h

See Also