Share via

CDatabase::GetBookmarkPersistence

  • Article

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 in Visual C++ Programmer's Guide.

CDatabase Overview |  Class Members |  Hierarchy Chart

See Also   CRecordset, CRecordset::CanBookmark, CRecordset::GetBookmark, CRecordset::SetBookmark