Класс IRowsetLocateImpl

Статья
02/20/2013

Реализует интерфейс 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
Блок памяти для всех дескрипторов строк держал закладкой.

Члены

Методы интерфейса

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

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

m_rgBookmarks

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

Заметки

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

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

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

Дополнительные сведения о реализации поддержки закладок см. в разделе Поддержка закладок поставщиками в Руководство по программированию Visual C++ и Закладки в Справочник по программированию OLE DB в PlatformSDK.