IOleLink::BindIfRunning
This method activates the connection between the linked object and the link source if the link source is already running.
HRESULT BindIfRunning(void);
Parameters
None.
Return Values
The following table shows the return values for this method.
| Value | Description |
|---|---|
| S_OK | The link source was bound. |
| S_FALSE | The link source is not running. |
| CreateBindCtx, IMoniker::IsRunning, or IOleLink::BindToSource errors | Binding the moniker might require calling these functions, therefore, errors generated by these functions can be returned. |
Remarks
You typically do not need to call IOleLink::BindIfRunning. This method is primarily called by the linked object.
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.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Oleidl.h, Oleidl.idl.
Link Library: Ole32.lib, Uuid.lib.
See Also
CreateBindCtx | IMoniker::IsRunning | IOleLink::BindToSource
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.