getColumnCount

Returns the number of columns 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 getColumnCount (
   DB_LORDINAL     *pcColumns);

Parameters

  • pcColumns
    [out] A pointer to the number of columns returned by the pcColumns argument. The number does not include the column label information. For asynchronous operations unable to determine a column 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.

Comments

Returned column values from an asynchronous operation cannot be negative.