IOleControl::OnAmbientPropertyChange
Informs a
control that one or more of the container s ambient properties (available
through the control site s IDispatch) has changed.
HRESULT
OnAmbientPropertyChange(
|
DISPID dispID |
//Dispatch identifier of the ambient property |
|
); |
|
Parameters
dispID
[in] Dispatch
identifier of the ambient property that changed. If the dispID parameter
is DISPID_UNKNOWN, it indicates that multiple properties changed. In this case,
the control should check all the ambient properties of interest to obtain their
current values.
Return Values
S_OK
Returned in
all cases.
Remarks
Notes to Implementers
S_OK is
returned in all cases even when the control does not support ambient properties
or some other failure has occurred. The caller sending the notification cannot
attempt to use an error code (such as E_NOTIMPL) to determine whether to send
the notification in the future. Such semantics are not part of this interface.