IRowsetChangeImpl Class

Visual Studio 2015

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at IRowsetChangeImpl Class.

The OLE DB Templates implementation of the IRowsetChange interface in the OLE DB specification.

Syntax

template <  
   class T,   
   class Storage,   
   class BaseInterface = IRowsetChange,   
   class RowClass = CSimpleRow,   
   class MapClass = CAtlMap < RowClass::KeyType, RowClass* >   
>  
class ATL_NO_VTABLE IRowsetChangeImpl : public BaseInterface

Parameters

T
A class derived from IRowsetChangeImpl.

Storage
The user record.

BaseInterface
The base class for the interface, such as IRowsetChange.

RowClass
The storage unit for the row handle.

MapClass
The storage unit for all row handles held by the provider.

Members

Interface Methods (Used with IRowsetChange)


DeleteRows	Deletes rows from the rowset.
InsertRow	Inserts a row into the rowset.
SetData	Sets data values in one or more columns.

Implementation Method (Callback)


FlushData	Overidden by provider to commit data to its store.

This interface is responsible for immediate write operations to a data store. "Immediate" means that when the end user (the person using the consumer) makes any changes, those changes are immediately transmitted to the data store (and cannot be undone).

IRowsetChangeImpl implements the OLE DB IRowsetChange interface, which enables updating of values of columns in existing rows, deleting rows, and inserting new rows.

The OLE DB Templates implementation supports all the base methods (SetData, InsertRow, and DeleteRows).

Important
It is strongly recommended that you read the following documentation BEFORE attempting to implement your provider:

Creating an Updatable Provider
Chapter 6 of the OLE DB Programmer's Reference
Also see how the RUpdateRowset class is used in the UpdatePV sample

Requirements

Header: atldb.h