IRowPosition

IRowPosition allows multiple components to share the concept of a current row over a rowset.

When to Implement

IRowPosition is not implemented by the provider. It is implemented by a common service provider component that works over any rowset.

When to Call

Components create a row position object in order to manage operations involving a current position within a rowset. Components call IRowPosition::SetRowPosition to specify that the hRow be considered the current row and call IRowPosition::GetRowPosition to retrieve the hRow specified as the current row. A code example is provided. Changing the current row generates notifications for any listeners of the row position object but makes no change to the position or state of the rowset itself.

Method

Description

ClearRowPosition

Clears the row position.

GetRowPosition

Retrieves the current row position.

GetRowset

Returns the current underlying Rowset.

Initialize

Sets the Rowset to be used by the row position object.

SetRowPosition

Sets the current row position.