MDAC 2.5 SDK - OLE DB Programmer's Reference
Chapter 4: Rowsets
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.