CRecordset::GetBookmark
Ottiene il valore del segnalibro per il record corrente.
void GetBookmark(
CDBVariant& varBookmark
);
Parametri
- varBookmark
Un riferimento a un oggetto CDBVariant che rappresenta il segnalibro nel record corrente.
Note
Per determinare se i segnalibri sono supportati nel recordset, chiamare CanBookmark. Per rendere disponibile se i segnalibri sono supportati, è necessario impostare l'opzione CRecordset::useBookmarks nel parametro dwOptions la funzione membro Apri.
Nota
Se i segnalibri non sono supportati o non disponibili, chiamare GetBookmark genereranno un'eccezione generata.I segnalibri non sono supportati nei recordset forward-only.
GetBookmark assegna il valore del segnalibro per il record corrente a un oggetto CDBVariant. Per tornare al record in qualsiasi momento dopo essere spostatosi a un altro record, chiamare SetBookmark con l'oggetto corrispondente CDBVariant.
Nota
Dopo alcune operazioni di recordset, i segnalibri possono non essere più validi.Ad esempio, se si chiama GetBookmark seguito da Requery, non è possibile tornare al record con SetBookmark.Chiamare CDatabase::GetBookmarkPersistence per controllare se è possibile chiamare in modo sicuro SetBookmark.
Per ulteriori informazioni sui bookmark e la navigazione del recordset, vedere gli articoli recordset: Segnalibri e absolute position (ODBC) e recordset: Scorrimento (ODBC).
Eccezioni
Questo metodo può generare eccezioni di tipo CDBException* e CMemoryException*.
Requisiti
Header: afxdb.h