Freigeben über


CDatabase::GetBookmarkPersistence

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

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

Referenz

CDatabase-Klasse

Hierarchiediagramm

CRecordset-Klasse

CRecordset::CanBookmark

CRecordset::GetBookmark

CRecordset::SetBookmark