Export (0) Print
Expand All

IOleInPlaceSite::OnInPlaceActivate method

Notifies the container that one of its objects is being activated in place.

Syntax


HRESULT OnInPlaceActivate();

Parameters

This method has no parameters.

Return value

This method returns S_OK if the container allows the in-place activation. Other possible return values include the following.

Return codeDescription
E_UNEXPECTED

An unexpected error has occurred.

 

Remarks

Notes to Callers

OnInPlaceActivate is called by the active embedded object when it is activated in-place for the first time. The container should note that the object is becoming active.

Notes to Implementers

A container that supports linking to embedded objects must properly manage the running of its in-place objects when they are UI-inactive and running in the hidden state. To reactivate the in-place object quickly, a container should not call IOleObject::Close until the container's IOleInPlaceSite::DeactivateAndUndo method is called. To help protect against the object being left in an unstable state if a linking client updates silently, the container should call OleLockRunning to lock the object in the running state. This prevents the hidden in-place object from shutting down before it can be saved in its container.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IOleInPlaceSite is defined as 00000119-0000-0000-C000-000000000046

See also

IOleInPlaceSite

 

 

Community Additions

ADD
Show:
© 2014 Microsoft