Поделиться через

Класс IRowsetNotifyCP

  • Статья

Реализует сайт поставщика для интерфейса точки подключения IRowsetNotify.

Синтаксис

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

Параметры

T
Класс, производный от IRowsetNotifyCP.

ReentrantEventSync
Класс мьютекса, поддерживающий повторное выполнение (по умолчанию CComSharedMutex). Мьютекс — это объект синхронизации, который позволяет одному потоку взаимоисключающий доступ к ресурсу.

piid
Указатель идентификатора интерфейса (IID*) для IRowsetNotify интерфейса точки подключения. Значение по умолчанию — &__uuidof(IRowsetNotify).

DynamicUnkArray
Массив типа CComDynamicUnkArray, который является динамически выделенным массивом указателей на интерфейсы приемника IUnknown клиента.

Требования

Заголовок: atldb.h

Участники

Методы

Имя Описание
Fire_OnFieldChange Уведомляет потребителя об изменении значения столбца.
Fire_OnRowChange Уведомляет потребителя об изменении, влияющего на строки.
Fire_OnRowsetChange Уведомляет потребителя об изменении, влияющего на весь набор строк.

Замечания

IRowsetNotifyCP реализует широковещательные функции, чтобы советовать прослушивателям точку IID_IRowsetNotify подключения изменений содержимого набора строк.

Обратите внимание, что необходимо также реализовать и зарегистрировать IRowsetNotify в потребителе (также называемом приемником) с помощью IRowsetNotifyImpl , чтобы потребитель смог обрабатывать уведомления. Ознакомьтесь с уведомлениями о реализации интерфейса точки подключения для потребителя.

Подробные сведения о реализации уведомлений см. в разделе "Поддержка уведомлений" в разделе "Создание обновляемого поставщика".

IRowsetNotifyCP::Fire_OnFieldChange

Передает событие OnFieldChange, чтобы уведомить потребителей об изменении значения столбца.

Синтаксис

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

Параметры

См. статью IRowsetNotify::OnFieldChange в справочнике программиста OLE DB.

IRowsetNotifyCP::Fire_OnRowChange

Передает событие OnRowChange всем прослушивателям в точке IID_IRowsetNotify подключения, чтобы уведомить потребителей об изменении, влияющего на строки.

Синтаксис

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

Параметры

См. раздел IRowsetNotify::OnRowChange в справочнике программиста OLE DB.

IRowsetNotifyCP::Fire_OnRowsetChange

Передает событие OnRowsetChange всем прослушивателям в точке IID_IRowsetNotify подключения, чтобы уведомить потребителей об изменении, влияющего на весь набор строк.

Синтаксис

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

Параметры

См. раздел IRowsetNotify::OnRowsetChange в справочнике программиста OLE DB.

См. также

Шаблоны поставщика OLE DB
Архитектура шаблона поставщика OLE DB
Уведомления (COM)
BEGIN_CONNECTION_POINT_MAP
END_CONNECTION_POINT_MAP
CONNECTION_POINT_ENTRY
Создание поставщика с возможностью записи