IRowsetUpdateImpl Class

Article
06/05/2017

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 IRowsetUpdateImpl Class.

The OLE DB Templates implementation of the IRowsetUpdate interface.

Syntax

template <  
   class T,   
   class Storage,   
   class UpdateArray = CAtlArray<Storage>,   
   class RowClass = CSimpleRow,   
   class MapClass = CAtlMap <RowClass::KeyType, RowClass*>   
>  
class IRowsetUpdateImpl : public IRowsetChangeImpl<  
   T,   
   Storage,   
   IRowsetUpdate,   
   RowClass,   
   MapClass  
>

Parameters

T
A class derived from IRowsetUpdateImpl.

Storage
The user record.

UpdateArray
An array containing cached data for updating the rowset.

RowClass
The storage unit for the HROW.

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

Members

Interface Methods (Used with IRowsetChange)

SetData

Sets data values in one or more columns.

Interface Methods (Used with IRowsetUpdate)

GetOriginalData	Gets the data most recently transmitted to or obtained from the data source, ignoring pending changes.
GetPendingRows	Returns a list of rows with pending changes.
GetRowStatus	Returns the status of specified rows.
Undo	Undoes any changes to the row since the last fetch or update.
Update	Transmits any changes made to the row since the last fetch or update.

Implementation Methods (Callback)

IsUpdateAllowed

Used to check for security, integrity, and so on before allowing updates.

Data Members

m_mapCachedData

Contains the original data for the deferred operation.

Remarks

You should first read and understand the documentation for IRowsetChange, because everything described there also applies here. You should also read chapter 6 of the OLE``DB``Programmer's``Reference on setting data.

IRowsetUpdateImpl implements the OLE DB IRowsetUpdate interface, which enables consumers to delay the transmission of changes made with IRowsetChange to the data source and undo changes before transmission.

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

Share via