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 |
|---|---|
|
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 |