IRowsetLocateImpl 类

项目
02/21/2013

实现 OLE DB IRowsetLocate 接口，获取从行集合中任意行。

template <
   class T, 
   class RowsetInterface, 
   class RowClass = CSimpleRow, 
   class MapClass = CAtlMap < RowClass::KeyType, RowClass* >, 
   class BookmarkKeyType = LONG, 
   class BookmarkType = LONG, 
   class BookmarkMapClass = CAtlMap < RowClass::KeyType, RowClass* >
>
class ATL_NO_VTABLE IRowsetLocateImpl : public IRowsetImpl<
   T, 
   RowsetInterface, 
   RowClass, 
   MapClass
>

参数

T
从 IRowsetLocateImpl派生的类。
RowsetInterface
从 IRowsetImpl派生的类。
RowClass
HROW的单元格。
MapClass
所有行句柄的单元格提供程序保留了。
BookmarkKeyType
书签的类型，如 LONG 或字符串。普通书签必须至少有两个字节的长度。 (单字节长度用于 OLE DB 标准书签DBBMK_FIRST， DBBMK_LAST和 DBBMK_INVALID是保留的。)
BookmarkType
维护的书签到数据关系的映射机制。
BookmarkMapClass
所有行句柄的单元格由书签保留了。

成员

接口方法

比较	比较两个书签。
GetRowsAt	获取行开始从书签的偏移量指定的行。
GetRowsByBookmark	获取与指定书签的行。
哈希	返回指定书签的哈希值。

数据成员

m_rgBookmarks

数组书签。

备注

IRowsetLocateImpl 是 IRowsetLocate 接口的 OLE DB 模板实现。 IRowsetLocate 用于获取从行集合中任意行。不实现该接口的行集合是 sequential 行集合。当 IRowsetLocate 位于行集合时，第 0 列是行的书签;读取此列将获取可用于重新定位到同一行的一个书签值。

IRowsetLocateImpl 在提供程序用于实现书签支持。书签是占位符 (在行集合的索引) 使使用者快速返回到行，允许对数据进行挂钩。提供者确定书签可以唯一地标识行。使用 IRowsetLocateImpl 方法，可以比较书签，在偏移量之前获取行，由书签获取行并返回书签的哈希值。

若要支持在行集合的 OLE DB 书签，此类使行集合继承。

有关实现书签支持的信息，请参见。 Visual C++ 程序员的准则中 OLE DB programmer's reference 的提供程序的书签支持和书签在 PlatformSDK。