CRecordset::GetBookmark

Artikel
02/26/2013

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.