IRowsetLocate : IRowset

IRowsetLocate is the interface for fetching arbitrary rows of a rowset. A rowset that does not implement this interface is a sequential rowset. IRowsetLocate is a prerequisite for IRowsetScroll.

When IRowsetLocate or one of its direct descendants is present on a rowset, then column 0 is the bookmark for the rows. Reading this column will obtain a bookmark value that can be used to reposition to the same row.

When to Implement

IRowsetLocate is required for all providers that intend to support general consumers.

Method Description
Compare Compares two bookmarks.
GetRowsAt Fetches rows, starting with the row specified by an offset from a bookmark.
GetRowsByBookmark Fetches the rows that match the specified bookmarks.
Hash Returns hash values for the specified bookmarks.