OLEDBSimpleProviderListener Interface and Methods

  • Article

OLEDBSimpleProviderListener is the OSP interface that specifies the methods to be implemented by the host for receiving notifications of data changes. It is identified by the following IID:

{E0E270C1-C0BE-11d0-8FE4-00A0C90A6341}

OSP implementers issue notifications of changes to the underlying data through a single event handler. The event handler, registered through OLEDBSimpleProvider::addOLEDBSimpleProviderListener, implements the OLEDBSimpleProviderListener notification methods.

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.

Notification Methods

Following is a list of the OSP notification methods available with the OSP Toolkit, along with a short description of each. There are pre-notifications and post-notifications for each event. (Remember that the OSP notifications represent only one category of possible notifications; there are also OLE DB notifications and data source notifications.) Click any method name for a description of its implementation.

Note

The simple provider must call the appropriate listener methods prior to, and after, the work is done in the insertRows, deleteRows, and setVariant methods of the OLEDBSimpleProvider interface. Failure to do so will leave the OLE DB rowset in an undetermined state, and consequently, calling IRowset::GetData would return unpredictable results.

Method

Description

aboutToChangeCell

Indicates that the specified cells are about to be modified.

aboutToDeleteRows

Indicates that one or more specified rows are about to be deleted.

aboutToInsertRows

Indicates that one or more specified rows are about to be inserted.

cellChanged

Indicates that the specified cells were changed.

deletedRows

Indicates that one or more specified rows were deleted.

insertedRows

Indicates that one or more specified rows were inserted.

rowsAvailable

Indicates that a specified sequence of rows is now available.

transferComplete

Indicates that the transfer of the entire data set exposed by OSP is complete.