IOleLink::UnbindSource (Windows Embedded CE 6.0)

1/6/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

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