CDatabase::GetBookmarkPersistence

 

Appelez cette fonction membre pour déterminer la persistance des signets sur un objet recordset après certaines opérations.

Syntaxe

DWORD GetBookmarkPersistence( ) const;

Valeur de retour

Un masque de bits qui identifie les opérations par lesquelles les signets persistent sur un objet recordset.  Pour plus d'informations, consultez Notes.  

Notes

Par exemple, si vous appelez CRecordset::GetBookmark, puis CRecordset::Requery, le signet obtenu à partir de GetBookmark risque de ne plus être valide.  Vous devez appeler GetBookmarkPersistence avant d'appeler CRecordset::SetBookmark.  

Le tableau suivant liste les valeurs de masque de bits qui peuvent être combinées pour la valeur de retour de GetBookmarkPersistence.

Valeur du masque de bits	Persistance des signets
SQL_BP_CLOSE	Les signets sont valides après une opération d'actualisation.
SQL_BP_DELETE	Le signet d'une ligne est valide après une opération de suppression sur cette ligne.
SQL_BP_DROP	Les signets sont valides après une opération de fermeture.
SQL_BP_SCROLL	Les signets sont valides après une opération de déplacement.  Permet simplement de déterminer si les signets sont pris en charge sur le recordset, comme cela est retourné par CRecordset::CanBookmark.
SQL_BP_TRANSACTION	Les signets sont valides après qu'une transaction est validée ou restaurée.
SQL_BP_UPDATE	Le signet d'une ligne est valide après une opération de mise à jour sur cette ligne.
SQL_BP_OTHER_HSTMT	Les signets associés à un objet recordset sont valides sur un deuxième recordset.

Pour plus d'informations sur cette valeur de retour, consultez la fonction d'API ODBC SQLGetInfo dans le SDK Windows.  Pour plus d'informations sur les signets, consultez l'article Recordset : signets et positions absolues (ODBC).  

Configuration requise

En-tête : afxdb.h

Voir aussi

CDatabase Class
Graphique hiérarchique
CRecordset Class
CRecordset::CanBookmark
CRecordset::GetBookmark
CRecordset::SetBookmark