Skip to content

Latest commit

 

History

History
72 lines (59 loc) · 2.86 KB

nf-ocidl-iolecontrol-onambientpropertychange.md

File metadata and controls

72 lines (59 loc) · 2.86 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:ocidl.IOleControl.OnAmbientPropertyChange
IOleControl::OnAmbientPropertyChange (ocidl.h)
Informs a control that one or more of the container's ambient properties has changed.
IOleControl interface [COM]
OnAmbientPropertyChange method
IOleControl.OnAmbientPropertyChange
IOleControl::OnAmbientPropertyChange
OnAmbientPropertyChange
OnAmbientPropertyChange method [COM]
OnAmbientPropertyChange method [COM]
IOleControl interface
_ctrl_iolecontrol_onambientpropertychange
com.iolecontrol_onambientpropertychange
ocidl/IOleControl::OnAmbientPropertyChange
com\iolecontrol_onambientpropertychange.htm
com
9ca43723-a14e-4f03-8eec-e10ab34ecb4d
12/05/2018
IOleControl interface [COM],OnAmbientPropertyChange method, IOleControl.OnAmbientPropertyChange, IOleControl::OnAmbientPropertyChange, OnAmbientPropertyChange, OnAmbientPropertyChange method [COM], OnAmbientPropertyChange method [COM],IOleControl interface, _ctrl_iolecontrol_onambientpropertychange, com.iolecontrol_onambientpropertychange, ocidl/IOleControl::OnAmbientPropertyChange
ocidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
OCIdl.idl
Windows
19H1
IOleControl::OnAmbientPropertyChange
ocidl/IOleControl::OnAmbientPropertyChange
c++
APIRef
kbSyntax
COM
OCIdl.h
IOleControl.OnAmbientPropertyChange

IOleControl::OnAmbientPropertyChange

-description

Informs a control that one or more of the container's ambient properties has changed.

-parameters

-param dispID [in]

The dispatch identifier of the ambient property that changed. If this 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.

-returns

This method returns S_OK 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.

-see-also

IOleControl