IOleLink::UnbindSource
A version of this page is also available for
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
| Header | Oleidl.h, oleidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IAdviseSink::OnClose
IDataObject::DUnadvise
IOleLink::BindToSource
IOleObject::Close
IOleObject::Unadvise
IUnknown::Release