MDAC 2.5 SDK - OLE DB Providers
OSP Toolkit

OLEDBSimpleProviderListener::aboutToChangeCell

Indicates that the specified cells are about to change. aboutToChangeCell is an event handler method, implemented through OLEDBSimpleProvider::addOLEDBSimpleProviderListener. This notification is issued when values are modified through OLEDBSimpleProvider::setVariant or internally through a provider, and before any data value changes are implemented.

HRESULT aboutToChangeCell (
   LONG   iRow,
   LONG   iColumn);

Parameters

iRow

[in]
The row position of the cell(s) to be changed.

iColumn

[in]
The column position of the cell(s) to be changed.

Return Codes

S_OK

The method succeeded.

E_FAIL

A provider-specific error occurred.

Comments

Calls to OLEDBSimpleProvider::getVariant should return the original, unchanged values or the values prior to the return of control from firing the OLEDBSimpleProviderListener::aboutToChangeCell event.

You can specify a value of -1 for iRow, iColumn, or for both.