CRecordset::SetBookmark

CRecordset::SetBookmark

void SetBookmark( const CDBVariant& varBookmark );

throw( CDBException, CMemoryException );

参数：varBookmark一个指向CDBVariant对象的引用，该对象包含了一个指定记录的书签值。

说明：

此成员函数用来将记录集定位在包含指定书签的记录上。为了确定在此记录集中是否支持书签，可以调用CanBookmark。如果支持书签，为了使书签可以使用，你必须设置Open成员函数中的dwOptions参数的CRecordset::useBookmarks选项。

注意：

如果书签不被支持或不能使用，调用SetBookmark将导致抛出一个异常。在只向前的记录集中是不支持书签的。

第一次获取当前记录的书签，可调用GetBookmark，它将书签值保存在一个CDBVariant对象中，用保存的书签值调用SetBookmark可以返回该记录。

注意：

在进行了一定的记录集操作之后，你必须在调用SetBookmark之前检查书签是否持续可用。例如，如果你用GetBookmark获取一个书签，然后调用Requery，则该书签也许已经不再有效了。调用CDabase::GetBookmarkPersistence来检查你是否能够安全地调用SetBookmark。