aboutToChangeCell

  • Article

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.

Important

This feature will be removed in a future version of Windows. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Instead, write a fully functional OLE DB provider using the native OLE DB interfaces.

Syntax

HRESULT aboutToChangeCell (
   DBROWCOUNT     iRow,
   DB_LORDINAL    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.