IOleLink::UnbindSource-Methode (oleidl.h)

Artikel
08/25/2023

Unterbricht die Verbindung zwischen einem verknüpften Objekt und seiner Linkquelle.

Syntax

HRESULT UnbindSource();

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

In der Regel rufen Sie UnbindSource nicht direkt auf. Wenn die Verbindung mit der Linkquelle deaktiviert werden muss, ruft Ihr Container in der Regel IOleObject::Close oder IUnknown::Release auf. Die Implementierung dieser Methoden durch das verknüpfte Objekt ruft UnbindSource auf. Die IAdviseSink::OnClose-Implementierung des verknüpften Objekts ruft auch UnbindSource auf.

Hinweise zu Implementierern

Die Implementierung von UnbindSource des verknüpften Objekts führt nichts aus, wenn die Linkquelle derzeit nicht gebunden ist. Wenn die Linkquelle gebunden ist, ruft UnbindSource die Implementierungen IOleObject::Unadvise und IDataObject::D Unadvise der Linkquelle auf, um die Empfehlungsverbindungen zur Linkquelle zu löschen. Die UnbindSource-Methode ruft auch die IOleContainer::LockContainer-Implementierung des zusammengesetzten Dokuments auf, um das enthaltende zusammengesetzte Dokument zu entsperren. Dadurch werden die Sperre für den Container und die in IOleLink::BindToSource eingerichteten Beratungsverbindungen aufgehoben. UnbindSource gibt alle Schnittstellenzeiger des verknüpften Objekts auf die Linkquelle frei.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleidl.h