void SetBookm&ark (const CDBVariantamp; varBookmark );
tirar (CDBException, CMemoryException);
Parámetros
varBookmark
Una referencia a un objeto CDBVariant que contiene el valor del marcador para un registro específico.
Observaciones
Llame a esta función miembro para colocar el juego de registros en el registro que contiene el marcador especificado. Para determinar si los marcadores son compatibles en el objeto recordset, llame a CanBookmark. Para que los marcadores disponibles si son compatibles, debe establecer la opción de CRecordset::useBookmarks en el parámetro dwOptions de la función miembro Open.
&Notanbsp; Si los marcadores no compatible o no está disponible, llamando a SetBookmark dará lugar a una excepción que se produce. Los marcadores no son compatibles con conjuntos de registros sólo hacia delante.
Para recuperar el marcador para el registro actual de la primera, llamada GetBookmark, que guarda el valor del marcador en un objeto CDBVariant . Más adelante, puede volver a ese registro llamando a SetBookmark utilizando el valor del marcador guardado.
&Notanbsp; Después de ciertas operaciones de conjunto de registros, debe comprobar la persistencia de marcador antes de llamar a SetBookmark. Por ejemplo, si se abre un marcador con GetBookmark y luego llama a Requery, el marcador ya no sea válido. Llame a CDatabase::GetBookmarkPersistence para comprobar si se puede llamar segura SetBookmark.
Para obtener más información acerca de marcadores y de navegación de juego de registros, vea los artículos Recordset: marcadores y posiciones absolutas (ODBC) y Recordset: desplazamiento (ODBC) en la Guía del programador de Visual C++.
Visió&n General de CRecordset |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambié&nnbsp;CRecordset::CanBookmark, CRecordset::GetBookmark, CRecordset::SetAbsolutePosition, CDatabase::GetBookmarkPersistence