Share via


IOleControlSite::LockInPlaceActive (Compact 2013)

3/26/2014

Indicates whether or not a control should remain in-place active. Calls to this method typically nest an event to ensure that the object's activation state remains stable throughout the processing of the event.

Syntax

HRESULT LockInPlaceActive( 
  BOOL fLock
);

Parameters

  • fLock
    [in] Indicates whether to ensure the in-place active state (TRUE) or to allow activation to change (FALSE). When TRUE, a supporting container must not deactivate the in-place object until this method is called again with FALSE.

Return Value

This method supports the following return values:

Value

Description

S_OK

The lock or unlock was made successfully.

E_NOTIMPL

The container does not support in-place locking.

Remarks

This method affects the control's in-place active state but not its UI-active state.

Requirements

Header

ocidl.h

See Also

Reference

IOleControlSite
COM Interfaces