Freigeben über


CDatabase::GetBookmarkPersistence

Rufen Sie die Memberfunktion auf, um die Beständigkeit von Lesezeichen auf einem Recordset-Objekt nach bestimmten Vorgängen zu bestimmen.

DWORD GetBookmarkPersistence( ) const;

Rückgabewert

Eine Bitmaske, die die Vorgänge identifiziert, durch die Lesezeichen auf einem Recordset-Objekt erhalten bleiben.Details finden Sie Hinweise.

Hinweise

Wenn Sie beispielsweise CRecordset::GetBookmark aufrufen und dann CRecordset::Requery aufrufen, kann das Lesezeichen von abgerufenen GetBookmark nicht mehr gültig.Sie sollten GetBookmarkPersistence aufrufen, bevor Sie CRecordset::SetBookmark aufrufen.

In der folgenden Tabelle werden die Bitmaskenwerte auf, die für den Rückgabewert von GetBookmarkPersistence kombiniert werden können.

Bitmaskenwert

Lesezeichenpersistenz

SQL_BP_CLOSE

Lesezeichen sind nach einem Requery Vorgang gültig.

SQL_BP_DELETE

Das Lesezeichen für eine Zeile wird 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 Move Vorgang gültig.Dies identifiziert einfach, wenn Lesezeichen auf das Recordset unterstützt werden, wie durch CRecordset::CanBookmark zurückgegeben.

SQL_BP_TRANSACTION

Lesezeichen sind gültig, nachdem eine Transaktion einen Commit oder Rollback ausgeführt wird.

SQL_BP_UPDATE

Das Lesezeichen für eine Zeile wird nach einem Update Vorgang in dieser Zeile gültig.

SQL_BP_OTHER_HSTMT

Die Lesezeichen, die einem Recordset-Objekt zugeordnet sind, sind auf einem zweiten Recordset gültig.

Weitere Informationen zu diesen Rückgabewert, finden Sie die ODBC-API-Funktion SQLGetInfo in Windows SDK.Weitere Informationen zu Lesezeichen, finden Sie im Artikel Recordset: Lesezeichen und absolute Positionen (ODBC).

Anforderungen

Header: afxdb.h

Siehe auch

Referenz

CDatabase-Klasse

Hierarchien-Diagramm

CRecordset-Klasse

CRecordset::CanBookmark

CRecordset::GetBookmark

CRecordset::SetBookmark