CRecordset::GetBookmark

void GetBookm&ark (CDBVariantamp; varBookmark );
Werfen Sie (CDBException, CMemoryException);

Parameter

varBookmark

Ein Verweis auf ein CDBVariant -Objekt, das Lesezeichen für den aktuellen Datensatz darstellt.

Bemerkungen

Rufen Sie diese Memberfunktion um den Lesezeichenwert für den aktuellen Datensatz abzurufen. Rufen Sie zum bestimmen, ob Lesezeichen, für das Recordset unterstützt werden, CanBookmark. Wenn Lesezeichen verfügbar wenn sie unterstützt werden, müssen Sie die CRecordset::useBookmarks -Option im Parameter DwOptions der Open -Memberfunktion festlegen.

Hinweis&Nbsp;  Wenn Lesezeichen nicht unterstützte oder nicht verfügbar sind, führt GetBookmark aufrufen eine Ausnahme. Lesezeichen werden in vorwärts-Recordsets nicht unterstützt.

GetBookmark weist den Wert des Lesezeichens für den aktuellen Datensatz auf ein CDBVariant -Objekt. Rufen Sie jederzeit nach dem Wechsel zu einem anderen Datensatz zu diesem Datensatz zurückkehren, mit dem entsprechenden Objekt CDBVariant SetBookmark.

Hinweis&Nbsp;  Nach bestimmten Recordset-Operationen möglicherweise Lesezeichen nicht mehr gültig. Beispielsweise wenn Sie GetBookmark gefolgt von Requeryaufrufen, Sie zurück zu dem Datensatz mit SetBookmarkmöglicherweise nicht. Rufen Sie CDatabase::GetBookmarkPersistence zu überprüfen, ob Sie SetBookmark sicher aufrufen können.

Weitere Informationen zu Lesezeichen und Recordsetnavigation finden Sie unter Artikel Recordset: Lesezeichen und Absolute Positionen (ODBC) und Recordset: Scrollen (ODBC) im Visual C++ Programmer's Guide.

CRecordset ÜbersichtMember der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CRecordset:: CanBookmark aufrufen, CRecordset::SetBookmark, CDatabase::GetBookmarkPersistence

Index