IRowsetNotifyCP 類別
實作連接點介面 IRowsetNotify 的提供者月臺。
語法
template <class T, class ReentrantEventSync = CComSharedMutex>
class IRowsetNotifyCP :
public IConnectionPointImpl<
T,
piid = &__uuidof(IRowsetNotify),
CComDynamicUnkArray DynamicUnkArray>,
public ReentrantEventSync
參數
T
衍生自 IRowsetNotifyCP
的類別。
ReentrantEventSync
支援重新進入的 Mutex 類別(預設值為 CComSharedMutex
)。 Mutex 是同步處理物件,可讓一個線程互斥存取資源。
piid
連接點介面的IRowsetNotify
介面標識碼指標 (IID*
)。 預設值是 &__uuidof(IRowsetNotify)
。
DynamicUnkArray
CComDynamicUnkArray 類型的陣列,這是用戶端接收介面指標的動態配置陣列IUnknown
。
需求
Header: 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
建立可更新的提供者