MDAC 2.5 SDK - OLE DB Providers
OSP Toolkit

OLEDBSimpleProviderListener::rowsAvailable

Indicates that a specified sequence of rows is now available. rowsAvailable is an event handler method, implemented through OLEDBSimpleProvider::addOLEDBSimpleProviderListener. This event method notifies data consumers that additional row information is available.

HRESULT rowsAvailable (
   LONG   iRow,
   LONG   cRows);

Parameters

iRow

[in]
Starting position of the available rows.

cRows

[in]
Number of available rows.

Return Codes

S_OK

The method succeeded.

E_FAIL

A provider-specific error occurred.

Comments

OSP consumers expect periodic notifications when data is available, because it is likely they will process or display the data as it arrives. Providers should weigh the advantage of simplifying code by firing this event once for each row—versus its performance impact.