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