次の方法で共有


IOleLink::BindIfRunning (Compact 2013)

3/26/2014

This method activates the connection between the linked object and the link source if the link source is already running.

Syntax

HRESULT BindIfRunning(void);

Parameters

None.

Return Value

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

Header

Oleidl.h,
oleidl.idl

Library

ole32.lib,
uuid.lib

See Also

Reference

IOleLink
CreateBindCtx
IMoniker::IsRunning
IOleLink::BindToSource