Skip to content

Latest commit

 

History

History
87 lines (65 loc) · 4.42 KB

nf-objidl-idataadviseholder-sendondatachange.md

File metadata and controls

87 lines (65 loc) · 4.42 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:objidl.IDataAdviseHolder.SendOnDataChange
IDataAdviseHolder::SendOnDataChange (objidl.h)
Sends notifications to each advise sink for which there is a connection established by calling the IAdviseSink::OnDataChange method for each advise sink currently being handled by this instance of the advise holder object.
IDataAdviseHolder interface [COM]
SendOnDataChange method
IDataAdviseHolder.SendOnDataChange
IDataAdviseHolder::SendOnDataChange
SendOnDataChange
SendOnDataChange method [COM]
SendOnDataChange method [COM]
IDataAdviseHolder interface
_ole_idataadviseholder_sendondatachange
com.idataadviseholder_sendondatachange
objidl/IDataAdviseHolder::SendOnDataChange
com\idataadviseholder_sendondatachange.htm
com
b7385116-2ec7-4e12-a2dc-c9029a38d8fd
12/05/2018
IDataAdviseHolder interface [COM],SendOnDataChange method, IDataAdviseHolder.SendOnDataChange, IDataAdviseHolder::SendOnDataChange, SendOnDataChange, SendOnDataChange method [COM], SendOnDataChange method [COM],IDataAdviseHolder interface, _ole_idataadviseholder_sendondatachange, com.idataadviseholder_sendondatachange, objidl/IDataAdviseHolder::SendOnDataChange
objidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
ObjIdl.idl
Windows
19H1
IDataAdviseHolder::SendOnDataChange
objidl/IDataAdviseHolder::SendOnDataChange
c++
APIRef
kbSyntax
COM
ObjIdl.h
IDataAdviseHolder.SendOnDataChange

IDataAdviseHolder::SendOnDataChange

-description

Sends notifications to each advise sink for which there is a connection established by calling the IAdviseSink::OnDataChange method for each advise sink currently being handled by this instance of the advise holder object.

-parameters

-param pDataObject [in]

A pointer to the IDataObject interface on the data object in which the data has just changed. This pointer is used in subsequent calls to IAdviseSink::OnDataChange.

-param dwReserved [in]

This parameter is reserved and must be 0.

-param advf [in]

Container for advise flags that specify how the call to IAdviseSink::OnDataChange is made. These flag values are from the enumeration ADVF. Typically, the value for advf is NULL. The only exception occurs when the data object is shutting down and must send a final notification that includes the actual data to sinks that have specified ADVF_DATAONSTOP and ADVF_NODATA in their call to IDataObject::DAdvise. In this case, advf contains ADVF_DATAONSTOP.

-returns

This method returns S_OK on success.

-remarks

The data object must call this method when it detects a change that would be of interest to an advise sink that has previously requested notification.

Most notifications include the actual data with them. The only exception is if the ADVF_NODATA flag was previously specified when the connection was initially set up in the IDataAdviseHolder::Advise method.

Before calling the IAdviseSink::OnDataChange method for each advise sink, this method obtains the actual data by calling the IDataObject::GetData method through the pointer specified in the pDataObject parameter.

-see-also

IAdviseSink::OnDataChange

IDataAdviseHolder