CRowset::MoveToBookmark

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ブックマークで指定された行、またはその行から指定されたオフセット (lSkip) 位置にある行をフェッチします。

HRESULT MoveToBookmark( 
   const CBookmarkBase& bookmark, 
   LONG lSkip = 0  
) throw( );

パラメータ

bookmark
[入力] フェッチするデータの場所を示すブックマーク。
lSkip
[入力] ブックマークから目的の行までの行数。0 を指定した場合、bookmark で指定した行がフェッチされる先頭の行となります。1 を指定した場合、bookmark で指定した行の直後の行が、フェッチされる先頭の行となります。–1 を指定した場合、bookmark で指定した行の直前の行が、フェッチされる先頭の行となります。

戻り値

標準の HRESULT を返します。

解説

このメソッドでは、省略可能なインターフェイス IRowsetLocate が必要です。これはすべてのプロバイダでサポートされているとは限りません。サポートされていない場合、このメソッドは E_NOINTERFACE を返します。また、行セットを含むテーブルまたはコマンドで Open を呼び出す前に、DBPROP_IRowsetLocate を VARIANT_TRUE、DBPROP_CANFETCHBACKWARDS を VARIANT_TRUE に設定する必要があります。

コンシューマでブックマークを使用する方法については、「ブックマークの使用」を参照してください。