Edit

Share via

IOleControlSite::LockInPlaceActive method (ocidl.h)

  • Article

Indicates whether 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(
  [in] BOOL fLock
);

Parameters

[in] fLock

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 can return the following values.

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ocidl.h

See also

IOleControlSite