IRowsetLocateImpl-Klasse

Artikel
06/10/2015

Implementiert die OLE DB- IRowsetLocate-Schnittstelle, die beliebige Zeilen aus einem Rowset abgerufen werden.

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 
>

Parameter

T
Eine Klasse wird von IRowsetLocateImpl abgeleitet.
RowsetInterface
Eine Klasse wird von IRowsetImpl abgeleitet.
RowClass
Die Speichereinheit für HROW.
MapClass
Die Speichereinheit für alle Zeilenhandles hielt vom Anbieter an.
BookmarkKeyType
Der Typ des Lesezeichens, wie LONG oder eine Zeichenfolge. Gewöhnliche Lesezeichen müssen eine Länge von zwei Bytes mindestens haben. (Einzelbytelänge wird für die OLE DB- StandardlesezeichenDBBMK_FIRST, DBBMK_LAST und DBBMK_INVALID.) reserviert
BookmarkType
Der Zuordnungsmechanismus für Wartungslesezeichen-zudatenbeziehungen.
BookmarkMapClass
Die Speichereinheit für alle Zeilenhandles hielt vom Lesezeichen an.

Member

Schnittstellenmethoden

Compare	Vergleicht zwei Lesezeichen.
GetRowsAt	Ruft das Zeilen Starten mit der Zeile, die durch einen UTC-Offset von einem Lesezeichen angegeben wird.
GetRowsByBookmark	Ruft die Zeilen, die die angegebenen Lesezeichen übereinstimmen.
Hash	Gibt Hashwerten für die angegebenen Lesezeichen zurück.

Datenmember

m_rgBookmarks

Ein Array Lesezeichen.

Hinweise

IRowsetLocateImpl ist die OLE DB-Vorlagen-Implementierung der IRowsetLocate-Schnittstelle. IRowsetLocate wird verwendet, um beliebige Zeilen aus einem Rowset abgerufen. Ein Rowset, das diese Schnittstelle nicht implementiert, ist ein sequential Rowset. Wenn IRowsetLocate für ein Rowset vorhanden ist, lautet Spalte 0 das Lesezeichen für die Linien; diese Spalte werden, erhält einen Lesezeichenwert, der verwendet werden kann, um zur gleichen Zeile neu anzuordnen.

IRowsetLocateImpl wird verwendet, um Unterstützung in den Anbieter zu implementieren. Lesezeichen sind die Platzhalter (Indizes für ein Rowset) das den Consumer aktivieren, um in eine Zeile schnell zurückzukehren und ermöglichen Hochgeschwindigkeitszugriff an Daten. Der Anbieter ermittelt, welche Lesezeichen eine Zeile eindeutig identifizieren können. Mit IRowsetLocateImpl können Sie Methoden Lesezeichen vergleichen, Zeilen nach Offset abrufen, Zeilen durch Lesezeichen abrufen, und Hashwerten für Lesezeichen zurückgeben.

Um in OLE DB-Lesezeichen einem Rowset zu unterstützen, führen Sie das Rowset erben von dieser Klasse.

Informationen zum Implementieren der Unterstützung, finden Sie unter Anbieterunterstützung für Lesezeichen und Lesezeichen in Visual C++ Programmer's Guide in OLE DB Programmer's Reference in PlatformSDK.