IOleControl::FreezeEvents
Indicates
whether the container is ignoring or accepting events from the control.
HRESULT
FreezeEvents(
|
BOOL bFreeze |
//Indicates whether to ignore or process events |
|
); |
|
Parameters
bFreeze
[out]
Indicates whether the container will ignore (TRUE) or now process (FALSE)
events from the control.
Return Values
S_OK
Returned in
all cases.
Remarks
The control
is not required to stop sending events when bFreeze is TRUE. However,
the container is not going to process them in this case. If a control depends
on the container s processing -- as with request events that return information
from the container -- the control must either discard the event or queue the
event to send later when IOleControl::FreezeEvents returns FALSE.
Notes to Implementers
As with IOleControl::OnAmbientPropertyChange, S_OK is returned in all
cases in order to prevent a container from making assumptions about a control s
behavior based on return values.