Share via

rowsAvailable

  • Article

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.

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 rowsAvailable (
   DBROWCOUNT   iRow,
   DBROWCOUNT   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.