IDataAdviseHolder::SendOnDataChange-Methode (objidl.h)

  • Artikel

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

Weitere Informationen

IAdviseSink::OnDataChange

IDataAdviseHolder