CRecordset::GetBookmark
Erhält der Lesezeichenwert für den aktuellen Datensatz.
void GetBookmark(
CDBVariant& varBookmark
);
Parameter
- varBookmark
Ein Verweis auf einen CDBVariant-Objekt, das das Lesezeichen im aktuellen Datensatz darstellt.
Hinweise
So bestimmen Sie, ob Lesezeichen auf das Recordset unterstützt werden, CanBookmark Aufruf. Um Lesezeichen bereitzustellen wenn sie unterstützt werden, müssen Sie die CRecordset::useBookmarks Option im dwOptions-Parameter der Memberfunktion Geöffnet festlegen.
Hinweis
Wenn Lesezeichen nicht unterstützt oder nicht verfügbar sind, führt das Aufrufen von GetBookmark eine Ausnahme, die ausgelöst wird.Lesezeichen werden in Vorwärts-Recordsets nicht unterstützt.
GetBookmark weist den Wert des Lesezeichens für den aktuellen Datensatz zu einem CDBVariant-Objekt zu. Um zu diesem Datensatz jederzeit zurückzukehren nachdem Sie zu einem anderen Datensatz verschoben haben, rufen Sie SetBookmark mit dem entsprechenden CDBVariant-Objekt auf.
Hinweis
Nach bestimmten Recordset-Operationen Lesezeichen sind möglicherweise nicht mehr gültig.Wenn Sie beispielsweise GetBookmark gefolgt von Requery aufrufen, sind Sie möglicherweise nicht in der Lage, den Datensatz mit SetBookmark zurückzukehren.Rufen Sie CDatabase::GetBookmarkPersistence auf, um sicherzustellen, dass Sie SetBookmark sicher aufrufen können.
Weitere Informationen zu Lesezeichen und Recordsetnavigation, finden Sie in Artikel Recordset: Lesezeichen und absolute Positionen (ODBC) und Recordset: Scrollen (ODBC).
Ausnahmen
Diese Methode kann Ausnahmen des Typs CDBException* und CMemoryException* auslösen.
Anforderungen
Header: afxdb.h