CRowset::MoveToBookmark

[アーティクル]
08/09/2011

ブックマークで指定された行、またはその行から指定されたオフセット (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 に設定する必要があります。

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