IOleLink::BindIfRunning method (oleidl.h)

Article
02/22/2024

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