IDataAdviseHolder::SendOnDataChange-Methode (objidl.h)
Sendet Benachrichtigungen an jede Empfehlungssenke, für die eine Verbindung hergestellt wird, indem die IAdviseSink::OnDataChange-Methode für jede Empfehlungssenke aufgerufen wird, die derzeit von dieser instance des advise holder-Objekts behandelt wird.
Syntax
HRESULT SendOnDataChange(
[in] IDataObject *pDataObject,
[in] DWORD dwReserved,
[in] DWORD advf
);
Parameter
[in] pDataObject
Ein Zeiger auf die IDataObject-Schnittstelle für das Datenobjekt, in dem sich die Daten gerade geändert haben. Dieser Zeiger wird in nachfolgenden Aufrufen von IAdviseSink::OnDataChange verwendet.
[in] dwReserved
Dieser Parameter ist reserviert und muss 0 sein.
[in] advf
Container für Empfehlungsflags, die angeben, wie der Aufruf von IAdviseSink::OnDataChange erfolgt. Diese Flagwerte stammen aus der -Enumeration ADVF. In der Regel ist der Wert für advfNULL. Die einzige Ausnahme tritt auf, wenn das Datenobjekt heruntergefahren wird und eine endgültige Benachrichtigung senden muss, die die tatsächlichen Daten an Senken enthält, die ADVF_DATAONSTOP und ADVF_NODATA in ihrem Aufruf von IDataObject::D Advise angegeben haben. In diesem Fall enthält advf ADVF_DATAONSTOP.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück.
Hinweise
Das Datenobjekt muss diese Methode aufrufen, wenn es eine Änderung erkennt, die für eine Empfehlungssenke von Interesse wäre, die zuvor eine Benachrichtigung angefordert hat.
Die meisten Benachrichtigungen enthalten die tatsächlichen Daten. Die einzige Ausnahme ist, wenn das flag ADVF_NODATA zuvor angegeben wurde, als die Verbindung in der IDataAdviseHolder::Advise-Methode eingerichtet wurde.
Vor dem Aufrufen der IAdviseSink::OnDataChange-Methode für jede Empfehlungssenke ruft diese Methode die tatsächlichen Daten ab, indem die IDataObject::GetData-Methode über den im pDataObject-Parameter angegebenen Zeiger aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h |