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