CRecordset::SetBookmark

在包含指定的书签的记录定位记录集。

void SetBookmark( 
   const CDBVariant& varBookmark  
);

参数

若要确定书签是否在记录集支持，请调用 CanBookmark。若要使书签可用，只要支持，必须在打开成员函数的 dwOptions 参数的 CRecordset::useBookmarks 选项。

说明
如果书签是不支持或可用，调用 SetBookmark 将导致引发的异常。书签在仅向前记录集不受支持。

先中检索当前记录的书签，调用 GetBookmark，保存书签值设置为 CDBVariant 对象。之后，使用保存的书签值，您可以返回到该记录通过调用 SetBookmark。

说明
在某些记录集操作后，应在调用 SetBookmark之前检查书签的持久性。例如，因此，如果检索与 GetBookmark 的书签然后调用 Requery，书签可能不再有效。调用 CDatabase::GetBookmarkPersistence 检查是否可以安全地调用 SetBookmark。