CRecordset::GetRowStatus

WORD GetRowStatus( WORD wRow ) const;

Return Value

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

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.

Remarks

Call this member function to obtain the status for a row in the current rowset. 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 ODBC SDK Programmer's Reference.

CRecordset OverviewClass MembersHierarchy Chart

See Also   CRecordset::CheckRowsetError, CRecordset::GetRowsFetched, CRecordset::RefreshRowset