Skip to content

Latest commit

 

History

History
126 lines (83 loc) · 4.81 KB

irowsetnotifyimpl-class.md

File metadata and controls

126 lines (83 loc) · 4.81 KB
description title ms.date f1_keywords helpviewer_keywords ms.assetid
Learn more about: IRowsetNotifyImpl Class
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
fbfd0cb2-38ff-4b42-899a-8de902f834b8

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