IRowPosition

OLE DB Programmer's Reference

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.

1998-2001 Microsoft Corporation. All rights reserved.