Classe IRowsetNotifyCP

  • Articolo

Implementa il sito del provider per l'interfaccia del punto di connessione IRowsetNotify.

Sintassi

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

Parametri

T
Classe derivata da IRowsetNotifyCP.

ReentrantEventSync
Classe mutex che supporta la reentrancy (l'impostazione predefinita è CComSharedMutex). Un mutex è un oggetto di sincronizzazione che consente a un thread l'accesso che si escludono a vicenda a una risorsa.

piid
Puntatore ID interfaccia (IID*) per un'interfaccia IRowsetNotify del punto di connessione. Il valore predefinito è &__uuidof(IRowsetNotify).

DynamicUnkArray
Matrice di tipo CComDynamicUnkArray, che è una matrice allocata dinamicamente di IUnknown puntatori alle interfacce sink client.

Requisiti

Intestazione: atldb.h

Membri

Metodi

Nome Descrizione
Fire_OnFieldChange Notifica al consumer di una modifica al valore di una colonna.
Fire_OnRowChange Notifica al consumer di una modifica che influisce sulle righe.
Fire_OnRowsetChange Notifica al consumer di una modifica che interessa l'intero set di righe.

Osservazioni:

IRowsetNotifyCP implementa funzioni di trasmissione per consigliare i listener sul punto IID_IRowsetNotify di connessione delle modifiche al contenuto del set di righe.

Si noti che è anche necessario implementare e registrare IRowsetNotify nel consumer (noto anche come "sink") usando IRowsetNotifyImpl in modo che il consumer possa gestire le notifiche. Vedere Ricezione di notifiche sull'implementazione dell'interfaccia del punto di connessione nel consumer.

Per informazioni dettagliate sull'implementazione delle notifiche, vedere "Notifiche di supporto" in Creazione di un provider aggiornabile.

IRowsetNotifyCP::Fire_OnFieldChange

Trasmette un evento OnFieldChange per notificare agli utenti una modifica al valore di una colonna.

Sintassi

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

Parametri

Vedere IRowsetNotify::OnFieldChange nella guida di riferimento per programmatori OLE DB.

IRowsetNotifyCP::Fire_OnRowChange

Trasmette un evento OnRowChange a tutti i listener nel punto IID_IRowsetNotify di connessione per notificare ai consumer una modifica che influisce sulle righe.

Sintassi

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

Parametri

Vedere IRowsetNotify::OnRowChange nella guida di riferimento per programmatori OLE DB.

IRowsetNotifyCP::Fire_OnRowsetChange

Trasmette un evento OnRowsetChange a tutti i listener nel punto IID_IRowsetNotify di connessione per notificare ai consumer una modifica che interessa l'intero set di righe.

Sintassi

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

Parametri

Vedere IRowsetNotify::OnRowsetChange nella guida di riferimento per programmatori OLE DB.

Vedi anche

Modelli di provider OLE DB
Architettura dei modelli di provider OLE DB
Notifiche (COM)
BEGIN_CONNECTION_POINT_MAP
END_CONNECTION_POINT_MAP
CONNECTION_POINT_ENTRY
Creazione di un provider aggiornabile