|
IDataAdviseHolder::SendOnDataChange
Sends notifications to each advise sink by calling the IAdviseSink::OnDataChange method for each advise sink currently being handled in this instance of IDataAdviseHolder.
HRESULT SendOnDataChange(
IDataObject * pDataObject,
| //Points to the data object that has changed
| DWORD dwReserved,
| //Reserved
| DWORD advf
| //Advise flag that specifies how to send the notification
| );
|
|
Parameters
pDataObject
[in]Points to the data object where the data has just changed. This data
object is used in the subsequent calls to IAdviseSink::OnDataChange.
dwReserved
[in]Reserved for future use; must be zero.
advf
[in]Contains the advise flag values 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.
Return Values
S_OK
The call to IAdviseSink::OnDataChange was made.
E_OUTOFMEMORY
Ran out of memory and the notifications could not be sent.
Comments
The data object calls 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 for the data object specified in the pDataObject parameter.
See Also
ADVF, IAdviseSink::OnDataChange
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
