CRecordset::GetRowStatus

Obtains the status for a row in the current rowset.

WORD GetRowStatus( 
   WORD wRow  
) const;

Parameters

  • wRow
    The one-based position of a row in the current rowset. This value can range from 1 to the size of the rowset.

Return Value

A status value for the row. For details, see Remarks.

Remarks

GetRowStatus returns a value that indicates either any change in status to the row since it was last retrieved from the data source, or that no row corresponding to wRow was fetched. The following table lists the possible return values.

Status value

Description

SQL_ROW_SUCCESS

The row is unchanged.

SQL_ROW_UPDATED

The row has been updated.

SQL_ROW_DELETED

The row has been deleted.

SQL_ROW_ADDED

The row has been added.

SQL_ROW_ERROR

The row is unretrievable due to an error.

SQL_ROW_NOROW

There is no row that corresponds to wRow.

For more information, see the ODBC API function SQLExtendedFetch in the Windows SDK.

Requirements

Header: afxdb.h

See Also

Reference

CRecordset Class

Hierarchy Chart

CRecordset::CheckRowsetError

CRecordset::GetRowsFetched

CRecordset::RefreshRowset