Sdílet prostřednictvím


CRecordset::GetBookmark

Získá hodnota záložky pro aktuální záznam.

void GetBookmark( 
   CDBVariant& varBookmark  
);

Parametry

  • varBookmark
    Odkaz na CDBVariant objekt představující záložku na aktuální záznam.

Poznámky

K určení, pokud jsou podporovány záložky v sadě záznamů, volání CanBookmark.K dispozici, pokud jsou podporovány záložky, je nutné nastavit CRecordset::useBookmarks možnost dwOptions parametr otevřených členské funkce.

[!POZNÁMKA]

Pokud záložky nepodporovaný nebo není k dispozici, volání GetBookmark výsledkem byla vyvolána výjimka.Záložky nejsou podporovány pouze pro předávání sady záznamů.

GetBookmarkpřiřadí hodnota záložky pro aktuální záznam CDBVariant objektu.Kdykoli po přesunutí na jiný záznam vrátit k, zavolejte na SetBookmark s odpovídajícím CDBVariant objektu.

[!POZNÁMKA]

Po určitých operací recordset záložky již nemusí být platné.Například volání GetBookmark a Requery, nebudete moci vrátit záznam s SetBookmark .Volání CDatabase::GetBookmarkPersistence zkontrolujte, zda lze bezpečně volat SetBookmark .

Další informace o záložky a navigační sady záznamů naleznete v článcích záznamů: záložky a absolutní pozice (ODBC) a záznamů: posouvání (ODBC).

Výjimky

Tuto metodu lze vyvolávají výjimky typu CDBException * a CMemoryException* .

Požadavky

Záhlaví: afxdb.h

Viz také

Referenční dokumentace

Třída CRecordset

Diagram hierarchie

CRecordset::CanBookmark

CRecordset::SetBookmark

CDatabase::GetBookmarkPersistence