DWORD GetBookmarkPersistence( ) const;
Return Value
A bitmask that identifies the operations through which bookmarks persist on a recordset object. For details, see Remarks.
Remarks
Call this member function to determine the persistence of bookmarks on a recordset object after certain operations. For example, if you call CRecordset::GetBookmark and then call CRecordset::Requery, the bookmark obtained from GetBookmark may no longer be valid. You should call GetBookmarkPersistence before calling CRecordset::SetBookmark.
The following table lists the bitmask values that can be combined for the return value of GetBookmarkPersistence.
Bitmask value | Bookmark persistence |
SQL_BP_CLOSE | Bookmarks are valid after a Requery operation. |
SQL_BP_DELETE | The bookmark for a row is valid after a Delete operation on that row. |
SQL_BP_DROP | Bookmarks are valid after a Close operation. |
SQL_BP_SCROLL | Bookmarks are valid after any Move operation. This simply identifies if bookmarks are supported on the recordset, as returned by CRecordset::CanBookmark. |
SQL_BP_TRANSACTION | Bookmarks are valid after a transaction is committed or rolled back. |
SQL_BP_UPDATE | The bookmark for a row is valid after an Update operation on that row. |
SQL_BP_OTHER_HSTMT | Bookmarks associated with one recordset object are valid on a second recordset. |
For more information about this return value, see the ODBC API function SQLGetInfo in the ODBC SDK Programmer's Reference. For more information about bookmarks, see the article Recordset: Bookmarks and Absolute Positions (ODBC) in Visual C++ Programmer's Guide.
CDatabase Overview | Class Members | Hierarchy Chart
See Also CRecordset, CRecordset::CanBookmark, CRecordset::GetBookmark, CRecordset::SetBookmark