CRecordset::GetBookmark

void GetBookmark( CDBVariant& varBookmark );
  throw( CDBException, CMemoryException );

参数:
varBookmark一个指向CDBVariant对象的引用,该对象代表在当前记录上的书签。

说明:
此成员函数用来获得当前记录的书签值。要确定此记录集是否支持书签,调用CanBookmark。如果支持书签,应用程序要使书签有效,就必须设置Open成员函数中的dwOptions的CRecordset::useBookmarks选项。
注意:
如果不支持书签或者是书签无效,调用GetBookmark将导致抛出一个异常。在只向前的记录集中是不支持书签的。
GetBookmark将当前记录的书签值分配给一个CDBVariant对象。在移动到另一个记录之后,要返回原来的记录,可以用相应的CDBVariant对象来调用SetBookmark。
注意:
在进行了一定的记录集操作后,书签也许就不再有效了。例如,如果你在调用GetBookmark之后接着调用了Requery,你也许就不能再用SetBookmark返回原来的记录了。调用CDatabase::GetBookmarkPersistence来检查你是否能够安全地调用SetBookmark。

请参阅:
CRecordset::CanBookmark, CRecordset::SetBookmark, CDatabase::GetBookmarkPersistence