IRowsetNotifyCP-Klasse

  • Artikel

Implementiert die Anbieterwebsite für die Verbindungspunktschnittstelle IRowsetNotify.

Syntax

template <class T, class ReentrantEventSync = CComSharedMutex>
class IRowsetNotifyCP :
   public IConnectionPointImpl<
      T,
      piid = &__uuidof(IRowsetNotify),
      CComDynamicUnkArray DynamicUnkArray>,
   public ReentrantEventSync

Parameter

T
Eine von IRowsetNotifyCP.

ReentrantEventSync
Eine Mutex-Klasse, die Reentrancy unterstützt (Der Standardwert ist CComSharedMutex). Ein Mutex ist ein Synchronisierungsobjekt, das einen Thread sich gegenseitig ausschließenden Zugriff auf eine Ressource zulässt.

piid
Ein Schnittstellen-ID-Zeiger (IID*) für eine IRowsetNotify Verbindungspunktschnittstelle. Der Standardwert ist &__uuidof(IRowsetNotify).

DynamicUnkArray
Ein Array vom Typ CComDynamicUnkArray, bei dem es sich um ein dynamisch zugewiesenes Array von IUnknown Zeigern auf die Client-Sinkschnittstellen handelt.

Anforderungen

Header: „atldb.h“

Member

Methoden

Name Beschreibung
Fire_OnFieldChange Benachrichtigt den Verbraucher über eine Änderung an den Wert einer Spalte.
Fire_OnRowChange Benachrichtigt den Verbraucher über eine Änderung, die sich auf die Zeilen auswirkt.
Fire_OnRowsetChange Benachrichtigt den Verbraucher über eine Änderung, die sich auf das gesamte Rowset auswirkt.

Hinweise

IRowsetNotifyCP implementiert Übertragungsfunktionen, um Listener über den Verbindungspunkt IID_IRowsetNotify von Änderungen am Inhalt des Rowsets zu beraten.

Beachten Sie, dass Sie den Verbraucher (auch als "Sink" bezeichnet) implementieren und registrieren IRowsetNotify müssen, indem Sie IRowsetNotifyImpl verwenden, damit der Verbraucher Benachrichtigungen verarbeiten kann. Weitere Informationen zum Implementieren der Verbindungspunktschnittstelle für den Verbraucher finden Sie unter "Empfangen von Benachrichtigungen ".

Ausführliche Informationen zum Implementieren von Benachrichtigungen finden Sie unter "Unterstützende Benachrichtigungen" beim Erstellen eines aktualisierbaren Anbieters.

IRowsetNotifyCP::Fire_OnFieldChange

Sendet ein OnFieldChange-Ereignis , um Verbraucher über eine Änderung an den Wert einer Spalte zu benachrichtigen.

Syntax

HRESULT Fire_OnFieldChange(IRowset* pRowset,
   HROW hRow,
   DBORDINAL cColumns,
   DBORDINAL* rgColumns,
   DBREASON eReason,
   DBEVENTPHASE ePhase,
   BOOL fCantDeny);

Parameter

Siehe IRowsetNotify::OnFieldChange in der OLE DB-Programmierreferenz.

IRowsetNotifyCP::Fire_OnRowChange

Sendet ein OnRowChange-Ereignis an alle Listener auf dem Verbindungspunkt IID_IRowsetNotify , um Verbraucher über eine Änderung zu informieren, die sich auf die Zeilen auswirkt.

Syntax

HRESULT Fire_OnRowChange(IRowset* pRowset,
   DBCOUNTITEM cRows,
   const HROW rghRows[],
   DBREASON eReason,
   DBEVENTPHASE ePhase,
   BOOL fCantDeny);

Parameter

Siehe IRowsetNotify::OnRowChange in der OLE DB-Programmierreferenz.

IRowsetNotifyCP::Fire_OnRowsetChange

Sendet ein OnRowsetChange-Ereignis an alle Listener auf dem Verbindungspunkt IID_IRowsetNotify , um Verbraucher über eine Änderung zu benachrichtigen, die sich auf das gesamte Rowset auswirkt.

Syntax

HRESULT Fire_OnRowsetChange(IRowset* pRowset,
   DBREASON eReason,
   DBEVENTPHASE ePhase,
   BOOL fCantDeny);

Parameter

Siehe IRowsetNotify::OnRowsetChange in der OLE DB-Programmierreferenz.

Siehe auch

OLE DB-Anbietervorlagen
Architektur von OLE DB-Anbietervorlagen
Benachrichtigungen (COM)
BEGIN_CONNECTION_POINT_MAP
END_CONNECTION_POINT_MAP
CONNECTION_POINT_ENTRY
Erstellen eines aktualisierbaren Anbieters