Compartir a través de


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

Vea también

Referencia

CRecordset Class

Gráfico de jerarquías

CRecordset::CanBookmark

CRecordset::SetBookmark

CDatabase::GetBookmarkPersistence