IOleLink::BindIfRunning method (oleidl.h)

Activates the connection between the linked object and the link source if the link source is already running.

Syntax

HRESULT BindIfRunning();

Return value

This method returns S_OK on success. Other possible return values include the following.

Return code Description
S_FALSE
The link source is not running.
 

Binding the moniker might require calling CreateBindCtx, IMoniker::IsRunning, or IOleLink::BindToSource; therefore, errors generated by these functions can also be returned.

Remarks

You typically do not need to call IOleLink::BindIfRunning. This method is primarily called by the linked object.

Notes to Implementers

The linked object's implementation of IOleLink::BindIfRunning checks the running object table (ROT) to determine whether the link source is already running. It checks both the relative and absolute monikers. If the link source is running, IOleLink::BindIfRunning calls IOleLink::BindToSource to connect the linked object to the link source.

Requirements

Requirement Value
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

IOleLink

IOleLink::BindToSource