Skip to content

Latest commit

 

History

History
125 lines (82 loc) · 4.75 KB

irowsetnotifyimpl-class.md

File metadata and controls

125 lines (82 loc) · 4.75 KB
title description ms.date f1_keywords helpviewer_keywords
IRowsetNotifyImpl Class
Learn more about: IRowsetNotifyImpl Class
11/04/2016
ATL.IRowsetNotifyImpl
ATL::IRowsetNotifyImpl
IRowsetNotifyImpl
IRowsetNotifyImpl.OnFieldChange
IRowsetNotifyImpl::OnFieldChange
OnFieldChange
IRowsetNotifyImpl::OnRowChange
IRowsetNotifyImpl.OnRowChange
OnRowChange
OnRowsetChange
IRowsetNotifyImpl::OnRowsetChange
IRowsetNotifyImpl.OnRowsetChange
IRowsetNotifyImpl class
OnFieldChange method
OnRowChange method
OnRowsetChange method

IRowsetNotifyImpl Class

Implements and registers IRowsetNotify on the consumer (also known as the "sink") so that it can handle notifications.

Syntax

class ATL_NO_VTABLE IRowsetNotifyImpl : public IRowsetNotify

Requirements

Header: atldbcli.h

Members

Methods

Name Description
OnFieldChange Notifies the consumer of any change to the value of a column.
OnRowChange Notifies the consumer of the first change to a row or of any change that affects the entire row.
OnRowsetChange Notifies the consumer of any change affecting the entire rowset.

Remarks

See Receiving Notifications about implementing the connection point interface on the consumer.

IRowsetNotifyImpl provides a dummy implementation for IRowsetNotify, with empty functions for the IRowsetNotify methods OnFieldChange, OnRowChange, and OnRowsetChange. If you inherit from this class when you implement an IRowsetNotify interface, you can implement only the methods you need. You also need to provide empty implementations for the other methods yourself.

IRowsetNotifyImpl::OnFieldChange

Notifies the consumer of any change to the value of a column.

Syntax

STDMETHOD(OnFieldChange)(
/* [in] */ IRowset* /* pRowset */,
/* [in] */ HROW /* hRow */,
/* [in] */ DBORDINAL /* cColumns */,
/* [size_is][in] */ DBORDINAL /* rgColumns */ [] ,
/* [in] */ DBREASON /* eReason */,
/* [in] */ DBEVENTPHASE /* ePhase */,
/* [in] */ BOOL /* fCantDeny */)

Parameters

See IRowsetNotify::OnFieldChange for parameter descriptions.

Return Value

See IRowsetNotify::OnFieldChange for return value descriptions.

Remarks

This method wraps the IRowsetNotify::OnFieldChange method. See that method's description in the OLE DB Programmer's Reference for details.

IRowsetNotifyImpl::OnRowChange

Notifies the consumer of the first change to a row or of any change that affects the entire row.

Syntax

STDMETHOD(OnRowChange)(
/* [in] */ IRowset* /* pRowset */,
/* [in] */ DBCOUNTITEM /* cRows */,
/* [size_is][in] */ const HROW /* rghRows*/ [] ,
/* [in] */ DBREASON /* eReason */,
/* [in] */ DBEVENTPHASE /* ePhase */,
/* [in] */ BOOL /* fCantDeny */)

Parameters

See IRowsetNotify::OnRowChange for parameter descriptions.

Return Value

See IRowsetNotify::OnRowChange for return value descriptions.

Remarks

This method wraps the IRowsetNotify::OnRowChange method. See that method's description in the OLE DB Programmer's Reference for details.

IRowsetNotifyImpl::OnRowsetChange

Notifies the consumer of any change affecting the entire rowset.

Syntax

STDMETHOD(OnRowsetChange)(
/* [in] */ IRowset* /* pRowset */,
/* [in] */ DBREASON /* eReason */,
/* [in] */ DBEVENTPHASE /* ePhase */,
/* [in] */ BOOL /* fCantDeny */)

Parameters

See IRowsetNotify::OnRowsetChange for parameter descriptions.

Return Value

See IRowsetNotify::OnRowsetChange for return value descriptions.

Remarks

This method wraps the IRowsetNotify::OnRowsetChange method. See that method's description in the OLE DB Programmer's Reference for details.

See also

OLE DB Consumer Templates
IRowsetNotify
IRowsetNotifyCP Class