IRowsetLocateImpl-Klasse

Artikel
02/26/2013

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

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 abgeleitet von IRowsetLocateImpl.
RowsetInterface
Eine Klasse abgeleitet von IRowsetImpl.
RowClass
Die Speichereinheit für HROW.
MapClass
Die Speichereinheit für alle Zeilenhandles hielt vom Anbieter an.
BookmarkKeyType
Der Typ des Lesezeichens LONG oder eine Zeichenfolge, z.Normale Lesezeichen müssen eine Länge von mindestens zwei Bytes haben.Länge des wird (ein Byte Lesezeichen Standard für OLE DB DBBMK_FIRST, DBBMK_LAST und DBBMK_INVALID) reserviert.
BookmarkType
Der Mechanismus zur Zuordnung für die Verwaltung von Lesezeichen-zu DATA-Verhältnissen.
BookmarkMapClass
Die Speichereinheit für alle Zeilenhandles hielt durch das Lesezeichen angezeigt.

Mitglieder

Schnittstellenmethoden

Compare	Vergleicht zwei Lesezeichen.
GetRowsAt	Ruft die Zeile ab, die der Zeile beginnen, die von einem Offset von einem Lesezeichen angegeben wird.
GetRowsByBookmark	Ruft die Zeile ab, die die angegebenen Lesezeichen übereinstimmen.
Hash	Gibt Hashwerte für die angegebenen Lesezeichen zurück.

Datenmember

m_rgBookmarks

Ein Array von Lesezeichen.

Hinweise

IRowsetLocateImpl OLE DB-Vorlagen handelt es sich bei der Implementierung der Schnittstelle. IRowsetLocateIRowsetLocate wird verwendet, um beliebige Zeilen aus einem Rowset abzurufen.Ein Rowset, das nicht über diese Schnittstelle implementiert, ist ein sequential Rowset.Wenn IRowsetLocate in einem Rowset vorhanden ist, ist das Lesezeichen Spalte 0 für die Zeilen. Beim Lesen dieser Spalte eines Lesezeichens abgerufen, der verwendet werden kann, um auf dieselbe Zeile neu anzuordnen.

IRowsetLocateImpl wird verwendet, um Unterstützung für Lesezeichen in den Anbieter zu implementieren.Lesezeichen können die Platzhalter (Indizes in einem Rowset), die den Consumer ermöglichen, schnell zu einer Zeile zurückzukehren und ermöglicht den Zugriff auf die Daten Hochgeschwindigkeits.Der Anbieter bestimmt, welche Lesezeichen eine Zeile eindeutig identifizieren können.Verwenden IRowsetLocateImpl-Methoden können Sie Lesezeichen vergleichen, Zeilen nach Offset von Zeilen abrufen, erhalten, Lesezeichen und Hashwerte für Lesezeichen zurückgeben.

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

Informationen zum Implementieren der Unterstützung für Lesezeichen finden Sie unter Anbieter-Unterstützung für Lesezeichen in Visual C++-Programmierhandbuch und Lesezeichen in OLE DB-Programmierreferenz in PlatformSDK.