getRowCount

  • Article

Returns the number of rows in the data set. For an asynchronous provider, returns the current number of rows in the data set.

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 getRowCount (
   DBROWCOUNT    *pcRows);

Parameters

  • pcRows
    [out] A pointer to the number of rows returned by the pcRow argument. The number does not include the row header information. For asynchronous operations unable to determine a row count (using OLEDBSimpleProvider::getEstimatedRows), a negative value may indicate that the operation is complete, which can cause unexpected results.

Return Codes

  • S_OK
    The method succeeded.

  • E_FAIL
    A provider-specific error occurred.