Skip to content

Latest commit

 

History

History
95 lines (76 loc) · 3.25 KB

nf-oleidl-iolelink-bindifrunning.md

File metadata and controls

95 lines (76 loc) · 3.25 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:oleidl.IOleLink.BindIfRunning
IOleLink::BindIfRunning (oleidl.h)
Activates the connection between the linked object and the link source if the link source is already running.
BindIfRunning
BindIfRunning method [COM]
BindIfRunning method [COM]
IOleLink interface
IOleLink interface [COM]
BindIfRunning method
IOleLink.BindIfRunning
IOleLink::BindIfRunning
_ole_iolelink_bindifrunning
com.iolelink_bindifrunning
oleidl/IOleLink::BindIfRunning
com\iolelink_bindifrunning.htm
com
791fbb3c-6b73-490c-a69b-ba58fd386de4
12/05/2018
BindIfRunning, BindIfRunning method [COM], BindIfRunning method [COM],IOleLink interface, IOleLink interface [COM],BindIfRunning method, IOleLink.BindIfRunning, IOleLink::BindIfRunning, _ole_iolelink_bindifrunning, com.iolelink_bindifrunning, oleidl/IOleLink::BindIfRunning
oleidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
OleIdl.Idl
Windows
19H1
IOleLink::BindIfRunning
oleidl/IOleLink::BindIfRunning
c++
APIRef
kbSyntax
COM
OleIdl.h
IOleLink.BindIfRunning

IOleLink::BindIfRunning

-description

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

-returns

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.

-see-also

IOleLink

IOleLink::BindToSource