MDAC 2.5 SDK - OLE DB Programmer's Reference
Chapter 4: Rowsets


 

Standard Bookmarks

Three standard bookmark values are provided: DBBMK_INVALID, DBBMK_FIRST, and DBBMK_LAST. All single-byte (length 1) bookmark values of type DBTYPE_BYTES are reserved for standard bookmarks. Ordinary bookmarks of type DBTYPE_BYTES must be at least length 2. The following constant is defined in Oledb.h as the standard bookmark length:

#define STD_BOOKMARKLENGTH 1

The values of the standard bookmarks listed in the following table are guaranteed to be the same for all providers.

Value Meaning
DBBMK_INVALID DBBMK_INVALID can be used by applications to initialize and subsequently check bookmark validity.
DBBMK_FIRST The first row of the rowset.

A consumer can fetch forward from this point. For example, if cRows is greater than zero and lRowsOffset is zero, IRowsetLocate::GetRowsAt returns the first cRows rows of the rowset.

A consumer cannot fetch backward before this point. For example, if cRows is -1 and lRowsOffset is zero, IRowsetLocate::GetRowsAt returns this row. If cRows is less than –1, it returns DB_S_ENDOFROWSET.

DBBMK_LAST The last row of the rowset. If the rowset is being populated asynchronously, this is the last row identified so far.

A consumer can fetch backward from this point. For example, if cRows is less than zero and lRowsOffset is zero, IRowsetLocate::GetRowsAt returns the last cRows rows of the rowset.

A consumer cannot fetch forward past this point. For example, if cRows is one and lRowsOffset is zero, IRowsetLocate::GetRowsAt returns this row. If cRows is greater than one, it returns DB_S_ENDOFROWSET.


The consumer can begin a sequential scan at either the first or last row.