CRecordset::GetBookmark
Obtiene el valor del marcador del registro actual.
void GetBookmark(
CDBVariant& varBookmark
);
Parámetros
- varBookmark
Una referencia a un objeto de CDBVariant que representa el marcador en el registro actual.
Comentarios
para determinar si los marcadores se admiten en el conjunto de registros, llamada CanBookmark.Para que los marcadores disponibles si se admiten, debe establecer la opción de CRecordset:: useBookmarks en el parámetro de dwOptions de funciones miembro de Abrir .
[!NOTA]
Si los marcadores son incompatibles o no disponible, llamar a GetBookmark producirá una excepción que produce.Los marcadores no se admiten en conjuntos de registros sólo hacia delante.
GetBookmark asigna el valor de marcador de posición para el registro actual en un objeto de CDBVariant .Para volver a ese registro en cualquier momento después de desplazarse a otro registro, llame a SetBookmark con el objeto correspondiente de CDBVariant .
[!NOTA]
Después de ciertas operaciones de conjunto de registros, los marcadores pueden dejado de ser válidos.Por ejemplo, si llama GetBookmark seguido de Requery, quizás no pueda volver al registro con SetBookmark.Llamada CDatabase:: GetBookmarkPersistence a comprobar si puede llamar con seguridad SetBookmark.
Para obtener más información sobre los marcadores y la navegación por conjuntos de registros, vea los artículos conjunto de registros: marcadores y posiciones absolutas (ODBC) y conjunto de registros: El desplazamiento (ODBC).
Excepciones
Este método puede producir excepciones de CDBException* escrito y de CMemoryException*.
Requisitos
encabezado: afxdb.h