IRowsetNotifyCP 类

实现连接点接口 IRowsetNotify 的提供程序站点。

语法

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

参数

T
派生自 IRowsetNotifyCP 的类。

ReentrantEventSync
支持重新进入的互斥类（默认值为 CComSharedMutex）。 mutex 是一个允许一个线程以互相排斥的方式访问一个资源的同步对象。

piid
IRowsetNotify 连接点接口的接口 ID 指针 (IID*)。 默认值是 &__uuidof(IRowsetNotify)。

DynamicUnkArray
CComDynamicUnkArray 类型的数组，是指向客户端接收器接口的 IUnknown 指针动态分配的数组。

要求

标头: atldb.h

成员

方法

名称	描述
Fire_OnFieldChange	将对列值所做的更改通知给使用方。
Fire_OnRowChange	将影响行的更改通知给使用方。
Fire_OnRowsetChange	将影响整个行集合的更改通知给使用方。

备注

IRowsetNotifyCP 实现广播函数，就行集内容的更改连接点 IID_IRowsetNotify 向侦听器提供建议。

请注意，还必须使用 IRowsetNotifyImpl 在使用者（也称为“接收器”）上实现和注册 IRowsetNotify，以便使用者可以处理通知。 请参阅接收通知，了解有关在使用者上实现连接点接口的信息。

有关实现通知的详细信息，请参阅创建可更新提供程序中的“支持通知”。

IRowsetNotifyCP::Fire_OnFieldChange

广播 OnFieldChange 事件，以通知使用者更改列值。

语法

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

参数

请参阅 OLE DB 程序员参考中的 IRowsetNotify::OnFieldChange。

IRowsetNotifyCP::Fire_OnRowChange

将 OnRowChange 事件广播到连接点 IID_IRowsetNotify 上的所有侦听器，以通知使用者影响行的更改。

语法

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

参数

请参阅 OLE DB 程序员参考中的 IRowsetNotify::OnRowChange。

IRowsetNotifyCP::Fire_OnRowsetChange

将 OnRowsetChange 事件广播到连接点 IID_IRowsetNotify 上的所有侦听器，以通知使用者影响整个行的更改。

语法

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

参数

请参阅 OLE DB 程序员参考中的 IRowsetNotify::OnRowsetChange。

另请参阅

OLE DB 提供程序模板
OLE DB 提供程序模板体系结构
通知 (COM)
BEGIN_CONNECTION_POINT_MAP
END_CONNECTION_POINT_MAP
CONNECTION_POINT_ENTRY
创建可更新的提供程序