IOleControlSite::LockInPlaceActive

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.

HRESULT LockInPlaceActive(
  BOOL fLock  //Indicates whether to ensure the active state
);
 

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 Values

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.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.