CRecordset::GetBookmark

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

更新 : 2007 年 11 月

現在のレコードのブックマーク値を取得します。

void GetBookmark( 
   CDBVariant& varBookmark  
);

パラメータ

varBookmark
現在のレコードのブックマークを示す CDBVariant オブジェクトへの参照。

解説

レコードセットでブックマークがサポートされているかどうかを調べるには、CanBookmark を呼び出します。ブックマークがサポートされている場合は、それを有効にするには、Open メンバ関数の dwOptions パラメータに CRecordset::useBookmarks オプションを設定します。

メモ :
ブックマークがサポートされていないか有効でない場合は、GetBookmark を呼び出すと例外がスローされます。ブックマークは、前方参照だけのレコードセットではサポートされていません。

GetBookmark は、現在のレコードのブックマークの値を CDBVariant オブジェクトに割り当てます。別のレコードに移動した後そのレコードに戻るには、対応する CDBVariant オブジェクトで SetBookmark を呼び出します。

メモ :
特定のレコードセット操作後は、ブックマークは無効になることがあります。たとえば GetBookmark の後に Requery を呼び出した場合は、SetBookmark でレコードに戻ることはできません。SetBookmark を安全に呼び出せるかどうかをチェックするには、CDatabase::GetBookmarkPersistence を呼び出します。