IPropertyNotifySink::OnChanged-Methode (ocidl.h)

  • Artikel

Benachrichtigt eine Senke, dass eine bindbare Eigenschaft geändert wurde.

Syntax

HRESULT OnChanged(
  [in] DISPID dispID
);

Parameter

[in] dispID

Der Verteilerbezeichner der Eigenschaft, die sich geändert hat, oder DISPID_UNKNOWN, wenn sich mehrere Eigenschaften geändert haben. Der Client (Besitzer der Senke) sollte den aktuellen Wert jeder interessanten Eigenschaft aus dem Objekt abrufen, das die Benachrichtigung generiert hat.

Rückgabewert

Diese Methode gibt in allen Fällen S_OK zurück.

Hinweise

S_OK wird in allen Fällen zurückgegeben, auch wenn die Senke keine [bindbaren] Eigenschaften benötigt oder wenn ein anderer Fehler aufgetreten ist. Kurz gesagt, das aufrufende Objekt sendet einfach die Benachrichtigung und kann nicht versuchen, einen Fehlercode (z. B. E_NOTIMPL) zu verwenden, um zu bestimmen, ob die Benachrichtigung in Zukunft nicht gesendet werden soll. Solche Semantik ist nicht Teil dieser Schnittstelle.

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 ocidl.h

Weitere Informationen

Ipropertynotifysink