Freigeben über


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

Weitere Informationen

IConnectionPoint

IConnectionPointContainer