Share via


IRowsetNotifyCP Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at IRowsetNotifyCP Class.

Implements the provider site for the connection point interface IRowsetNotify.

Syntax

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

Parameters

T
A class derived from IRowsetNotifyCP.

ReentrantEventSync
A mutex class that supports reentrancy (the default is CComSharedMutex). A mutex is a synchronization object that allows one thread mutually exclusive access to a resource.

piid
A interface ID pointer (IID*) for an IRowsetNotify connection point interface. The default value is &__uuidof(IRowsetNotify).

DynamicUnkArray
An array of type CComDynamicUnkArray, which is a dynamically allocated array of IUnknown pointers to the client sink interfaces.

Members

Methods

Fire_OnFieldChange Notifies the consumer of a change to the value of a column.
Fire_OnRowChange Notifies the consumer of a change affecting the rows.
Fire_OnRowsetChange Notifies the consumer of a change affecting the entire rowset.

Remarks

IRowsetNotifyCP implements broadcast functions to advise listeners on the connection point IID_IRowsetNotify of changes to the contents of the rowset.

Note that you must also implement and register IRowsetNotify on the consumer (also known as the "sink") using IRowsetNotifyImpl so that the consumer can handle notifications. See Receiving Notifications about implementing the connection point interface on the consumer.

For detailed information on implementing notifications, see "Supporting Notifications" in Creating an Updatable Provider.

Requirements

Header: atldb.h

See Also

OLE DB Provider Templates
OLE DB Provider Template Architecture
Notifications (COM)
Overview of Notifications (OLE DB)
BEGIN_CONNECTION_POINT_MAP
END_CONNECTION_POINT_MAP
CONNECTION_POINT_ENTRY
Creating an Updatable Provider