CRecordset::GetBookmark
現在のレコードのブックマークの値を取得します。
void GetBookmark(
CDBVariant& varBookmark
);
パラメーター
- varBookmark
現在のレコードのブックマークを表す CDBVariant のオブジェクトへの参照。
解説
レコードセット内でブックマークがサポートされているかどうかを調べるには、呼び出し CanBookmark。これらがサポートされている場合、ブックマークを使用できるようにするには、[開く] のメンバー関数の dwOptions のパラメーターの CRecordset::useBookmarks オプションを設定する必要があります。
[!メモ]
ブックマークがサポートされていないか、使用できない場合に、GetBookmark を呼び出すと、例外がスローされます。ブックマークは、前方スクロール専用レコードセットではサポートされていません。
GetBookmark は CDBVariant のオブジェクトには、現在のレコードのブックマークの値を割り当てます。別のレコードへの移動後に、そのレコードに常に戻るには、CDBVariant の対応するオブジェクトとの SetBookmark を呼び出します。
[!メモ]
特定のレコードセットの操作の後、ブックマークが無効かがあります。たとえば、GetBookmark を [再クエリ]に表示されている呼び出すと、SetBookmarkのレコードに戻れます場合があります。SetBookmarkを安全に呼び出すことができるかどうかを確認するに CDatabase::GetBookmarkPersistence を呼び出します。
ブックマーク、レコードセットの移動に関する詳細については、" " レコードセット: ブックマークと絶対位置 (ODBC) と レコードセット: スクロール (ODBC)を参照してください。
例外
このメソッドは、型 CDBException* と **CMemoryException***の例外をスローできます。
必要条件
Header: afxdb.h