IOleInPlaceSite::OnInPlaceActivate-Methode (oleidl.h)

Benachrichtigt den Container, dass eines seiner Objekte aktiviert wird.

Syntax

HRESULT OnInPlaceActivate();

Rückgabewert

Diese Methode gibt S_OK zurück, wenn der Container die direkte Aktivierung zulässt. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Hinweise für Anrufer

OnInPlaceActivate wird vom aktiven eingebetteten Objekt aufgerufen, wenn es zum ersten Mal direkt aktiviert wird. Der Container sollte beachten, dass das Objekt aktiv wird.

Hinweise für Implementierer

Ein Container, der das Verknüpfen mit eingebetteten Objekten unterstützt, muss die Ausführung seiner direkten Objekte ordnungsgemäß verwalten, wenn sie inaktiv sind und im ausgeblendeten Zustand ausgeführt werden. Um das direkte Objekt schnell zu reaktivieren, sollte ein Container IOleObject::Close erst aufrufen, wenn die IOleInPlaceSite::D eactivateAndUndo-Methode des Containers aufgerufen wird. Um zu verhindern, dass das Objekt in einem instabilen Zustand verbleibt, wenn ein verknüpfender Client im Hintergrund aktualisiert wird, sollte der Container OleLockRunning aufrufen, um das Objekt im ausgeführten Zustand zu sperren. Dadurch wird verhindert, dass das ausgeblendete direkte Objekt heruntergefahren wird, bevor es in seinem Container gespeichert werden kann.

Anforderungen

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

Weitere Informationen

IOleInPlaceSite