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。