MDAC 2.5 SDK - OLE DB Programmer's Reference
Appendix I: Row Position Object


 

 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.