IOleLink::UnbindSource

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method deactivates the connection between a linked object and its link source.

Syntax

HRESULT UnbindSource(void);

Parameters

None.

Return Value

If the method succeeds, the return value is S_OK.

Remarks

You typically do not call IOleLink::UnbindSource directly.

When it is necessary to deactivate the connection to the link source, your container typically calls the IOleObject::Close or IUnknown::Release method; the linked object's implementation of these methods calls IOleLink::UnbindSource.

The linked object's IAdviseSink::OnClose implementation also calls IOleLink::UnbindSource.

The linked object's implementation of IOleLink::UnbindSource does nothing if the link source is not currently bound.

If the link source is bound, IOleLink::UnbindSource calls the link source's IOleObject::Unadvise and IDataObject::DUnadvise implementations to delete the advisory connections to the link source.

IOleLink::UnbindSource releases all the linked object's interface pointers to the link source.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

See Also

Reference

IAdviseSink::OnClose
IDataObject::DUnadvise
IOleLink::BindToSource
IOleObject::Close
IOleObject::Unadvise
IUnknown::Release