Export (0) Print
Expand All

IOleLink::BindIfRunning method

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

Syntax


HRESULT BindIfRunning();

Parameters

This method has no parameters.

Return value

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

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleLink is defined as 0000011d-0000-0000-C000-000000000046

See also

IOleLink
IOleLink::BindToSource

 

 

Community Additions

ADD
Show:
© 2014 Microsoft