IPropertyNotifySink-Schnittstelle (ocidl.h)
Wird von einem Senkenobjekt implementiert, um Benachrichtigungen über Eigenschaftenänderungen von einem Objekt zu empfangen, das IPropertyNotifySink als ausgehende Schnittstelle unterstützt. Der Client, der die Benachrichtigungen in dieser Schnittstelle empfangen muss (von einem unterstützenden verbindungsfähigen Objekt), erstellt eine Senke mit dieser Schnittstelle und verbindet sie über den Verbindungspunktmechanismus mit dem zu verbindenden Objekt. Weitere Informationen zu Verbindungspunkten finden Sie unter IConnectionPointContainer.
Vererbung
Die IPropertyNotifySink-Schnittstelle erbt von der IUnknown-Schnittstelle . IPropertyNotifySink verfügt auch über folgende Membertypen:
Methoden
Die IPropertyNotifySink-Schnittstelle verfügt über diese Methoden.
| IPropertyNotifysink::OnChanged Benachrichtigt eine Senke, dass eine bindbare Eigenschaft geändert wurde. |
| IPropertyNotifySink::OnRequestEdit Benachrichtigt eine Senke, dass sich eine requestedit-Eigenschaft ändert. |
Hinweise
Das -Objekt selbst muss die Methoden von IPropertyNotifySink nur für die Eigenschaften aufrufen, die in den Typinformationen des Objekts mit den Attributen [bindable] und [requestedit] gekennzeichnet sind. Wenn das Objekt eine [bindbare] Eigenschaft ändert, muss IPropertyNotifySink::OnChanged aufgerufen werden. Wenn das Objekt eine [requestedit]-Eigenschaft ändern möchte, muss es vor dem Ändern der Eigenschaft IPropertyNotifySink::OnRequestEdit aufrufen und auch die aktion berücksichtigen, die von der Senke bei der Rückgabe von diesem Aufruf angegeben wird.
Die einzige Ausnahme von dieser Regel ist, dass keine Benachrichtigungen als Ergebnis der Initialisierungs- oder Ladeprozeduren eines Objekts gesendet werden. Zur Initialisierungszeit wird davon ausgegangen, dass sich alle Eigenschaften ändern und dass alle änderungen zulässig sein müssen. Benachrichtigungen an diese Schnittstelle sind daher nur im Kontext eines vollständig initialisierten/geladenen Objekts sinnvoll.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ocidl.h |