Класс IRowsetLocateImpl

Статья
06/10/2015

Реализует интерфейс IRowsetLocate, OLE DB, который обращается к произвольные строки из набора строк.

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
Тип закладки, например ДЛИННОЕ или строка. Обычные закладки должны иметь длину не менее 2 байт. Однобайтовая (длина зарезервировано для OLE DB стандартные закладкиDBBMK_FIRST, DBBMK_LAST и DBBMK_INVALID).
BookmarkType
Механизм сопоставления для поддержки связей закладка-к- данных.
BookmarkMapClass
Блок памяти для всех дескрипторов строк удержатьых закладкой.

Члены

Методы Interface

Сравнение	Сравнивает 2 закладки.
GetRowsAt	Получение строк, начиная со строки, заданной смещением от закладки.
GetRowsByBookmark	Получение строк, соответствующих определенным закладкам.
Хэш	Возвращает значения хэша для определенных закладок.

Элементы данных

m_rgBookmarks

Массив закладок.

Заметки

IRowsetLocateImpl реализация интерфейса OLE DB IRowsetLocate. IRowsetLocate используется для получения произвольные строки из набора строк. Набор строк, который не реализует этот интерфейс набора строк sequential. При IRowsetLocate есть на наборе строк, столбец 0 закладки для строк; чтение в данном столбце получит значение закладки, которую можно использовать для перемещения в одной строке.

IRowsetLocateImpl используется для реализации поддержки закладок в поставщиках. Закладки заполнители (индексы в наборе строк), объект-получатель позволяет быстро вернуться к строке, позволяя высокоскоростной доступ к данным. Поставщик указывает, какую закладки могут уникально идентифицировать строку. С помощью методов IRowsetLocateImpl, можно сравнить закладки, получение строк смещением, выборки строк и и возвращает значения хэша для закладок.

Для поддержки закладок OLE DB в наборе строк используйте набор строк наследовать от этого класса.

Сведения о реализации поддержки закладок см. в разделе Поддержка закладок в Закладки в Visual C++ Programmer's Guide и OLE DB Programmer's Reference в PlatformSDK.