CRecordset::GetBookmark
Obtient la valeur du signet de l'enregistrement actuel.
void GetBookmark(
CDBVariant& varBookmark
);
Paramètres
- varBookmark
Une référence à un objet de CDBVariant représentant le signet sur l'enregistrement courant.
Notes
Pour déterminer si les signets sont pris en charge dans le recordset, appelez CanBookmark. Pour rendre les signets disponibles s'ils sont pris en charge, vous devez définir l'option de CRecordset::useBookmarks dans le paramètre d' dwOptions de la fonction membre d' Ouvrez .
Notes
Si les signets sont non pris en charge ou non disponibles, appeler GetBookmark entraîne une exception est levée.Les signets ne sont pas pris en charge sur les recordsets en avant seulement.
GetBookmark assigne la valeur du signet de l'enregistrement actuel à un objet d' CDBVariant . Pour revenir à cet enregistrement à tout moment après avoir déplacé dans un autre enregistrement, appelez SetBookmark avec l'objet correspondant d' CDBVariant .
Notes
Après certaines opérations de recordset, les signets ne peuvent plus être valides.Par exemple, si vous appelez GetBookmark suivi de Requery, vous ne pouvez pas pouvoir revenir à l'enregistrement avec SetBookmark.Appelez CDatabase::GetBookmarkPersistence pour vérifier si vous pouvez appeler sans risque SetBookmark.
Pour plus d'informations sur les signets et la navigation au sein d'un recordset, consultez les articles recordset : Signets et positions absolues (ODBC) et recordset : Défilement (ODBC).
Exceptions
Cette méthode peut lever des exceptions de type CDBException* et CMemoryException*.
Configuration requise
Header: afxdb.h