CDatabase::GetBookmarkPersistence

 

Rufen Sie diese Member-Funktion auf, um die Beibehaltung von Lesezeichen auf einem recordset-Objekt nach bestimmten Vorgängen festzulegen.

Syntax

DWORD GetBookmarkPersistence( ) const;

Rückgabewert

Eine Bitmaske, die die Vorgänge identifiziert, mit denen Lesezeichen auf einem recordset-Objekt beibehalten werden.  Einzelheiten finden Sie unter "Hinweise".  

Hinweise

Wenn Sie beispielsweise CRecordset::GetBookmark und dann CRecordset::Requery aufrufen, ist das Lesezeichen von GetBookmark womöglich nicht mehr gültig.  Sie sollten GetBookmarkPersistence vor CRecordset::SetBookmark aufrufen.  

Die folgende Tabelle enthält die Bitmaskenwerten, die für den Rückgabewert von GetBookmarkPersistence kombiniert werden können.

Bitmaskenwert	Lesezeichenbeibehaltung
SQL_BP_CLOSE	Lesezeichen sind nach einem Erneut abfragen-Vorgang gültig.
SQL_BP_DELETE	Das Lesezeichen für eine Zeile ist nach einem Löschen-Vorgang in dieser Zeile gültig.
SQL_BP_DROP	Lesezeichen sind nach einem Schließen-Vorgang gültig.
SQL_BP_SCROLL	Lesezeichen sind nach jedem Verschieben-Vorgang gültig.  Damit wird mühelos identifiziert, ob Lesezeichen im Datensatz unterstützt werden, wie von CRecordset::CanBookmark zurückgegeben.
SQL_BP_TRANSACTION	Lesezeichen sind gültig, nachdem eine Transaktion übernommen oder zurückgesetzt wurde.
SQL_BP_UPDATE	Das Lesezeichen für eine Zeile ist nach einem Aktualisieren-Vorgang in dieser Zeile gültig.
SQL_BP_OTHER_HSTMT	Lesezeichen, die mit einem recordset-Objekt verbunden sind, sind in einem zweiten Datensatz gültig.

Weitere Informationen zu diesem Rückgabewert finden Sie unter der ODBC API-Funktion SQLGetInfo im Windows SDK.  Weitere Informationen über Lesezeichen finden Sie im Artikel Recordset: Lesezeichen und absolute Positionen (ODBC).  

Anforderungen

Header: afxdb.h

Siehe auch

CDatabase Class
Hierarchiediagramm
CRecordset Class
CRecordset::CanBookmark
CRecordset::GetBookmark
CRecordset::SetBookmark