IRowsetLocateImpl クラス

行セットの任意の行をフェッチ 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
  長いまたは文字列などのブックマークの種類。通常のブックマークは少なくとも 2 バイトの期間が必要です。（シングルバイトの継続時間は、 OLE DB 標準ブックマークDBBMK_FIRST、 DBBMK_LASTと DBBMK_INVALIDのために予約されています）。

• BookmarkType
  保守のブックマークにデータ リレーションシップのマッピングの機能。

• BookmarkMapClass
  すべての行ハンドルの格納の単位はブックマークによって保持します。

メンバー

インターフェイス メソッド

Compare	2 個のブックマークを比較します。
GetRowsAt	フェッチはブックマークからのオフセットで指定した行から開始を行。
GetRowsByBookmark	指定されたブックマークに一致する行をフェッチします。
ハッシュ	指定されたブックマークのハッシュ値を返します。

データ メンバー

m_rgBookmarks

ブックマークの配列。

解説

IRowsetLocateImpl は IRowsetLocate インターフェイスの OLE DB テンプレートの実装です。IRowsetLocate が行セットの任意の行をフェッチために使用されます。このインターフェイスを実装しない行セットは sequential の行セットです。IRowsetLocate が行セットにときに、 0 列は、行のブックマークいます; この列を読み取ることは同じ行に再配置するために使用できるブックマーク値を取得します。

IRowsetLocateImpl がプロバイダーのブックマーク サポートを実装するために使用されます。ブックマークはプレースホルダー （行セットのインデックス）が効果行にすぐに制御を返すコンシューマーにデータにすばやくアクセスを許可します。プロバイダーは、ブックマークが行を識別できるかを判定します。IRowsetLocateImpl のメソッドを使用して、ブックマークを比較し、オフセットによって行をフェッチして、ブックマークによって行をフェッチして、ブックマークのハッシュ値を返すことができます。

行セットの OLE DB のブックマークをサポートするには、このクラスから行セットを継承します。

ブックマーク サポートの実装の詳細については、 Visual C++ のプログラミングのガイド の ブックマークのプロバイダー サポート と PlatformSDKの OLE DB Programmer's Reference の ブックマーク を参照してください。

必要条件

ヘッダー: atldb.h

参照

関連項目

IRowsetLocate:IRowset

プロバイダーのブックマーク サポート

Bookmarks

概念

OLE DB プロバイダー テンプレート (C++)

OLE DB プロバイダー テンプレートのアーキテクチャ