Row Status

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. Microsoft recommends using the driver's cursor functionality.

The cursor library creates a buffer in the cache for the row status. The cursor library retrieves values for the row status array (specified with the SQL_ATTR_ROW_STATUS_PTR statement attribute) from this buffer. For each row, the cursor library sets this buffer to:

  • SQL_ROW_DELETED when it executes a positioned delete statement on the row.

  • SQL_ROW_ERROR when it encounters an error retrieving the row from the data source with SQLFetch.

  • SQL_ROW_SUCCESS when it successfully fetches the row from the data source with SQLFetch.

  • SQL_ROW_UPDATED when it executes a positioned update statement on the row.