Click to Rate and Give Feedback
MSDN
MSDN Library
COM
Reference
Interfaces
IOleControl
 IOleControl::OnAmbientPropertyChang...
COM
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
);
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.

S_OK

Returned in all cases.

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.

For an explanation of the requirement values, see Requirements (COM).

Windows NT/2000/XP: Requires Windows NT 4.0 or later.

Windows 95/98: Requires Windows 95 or later.

Header: Declared in ocidl.h.

Send comments about this topic to Microsoft.
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker