IRowsetNotifyImpl Class

  • Article

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