CRecordset::GetBookmark

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

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

void GetBookmark( 
   CDBVariant& varBookmark  
);

パラメーター

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

解説

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

注意

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

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

注意

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

ブックマークとレコードセットの移動の詳細についてを参照してくださいレコードセット：ブックマークと絶対位置 (ODBC) とレコードセット：スクロール (ODBC)。