IPropertyNotifySink::OnChanged-Methode (ocidl.h)
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 |