CRecordset::SetBookmark
Coloca el conjunto de registros respecto al registro que contiene el marcador especificado.
void SetBookmark(
const CDBVariant& varBookmark
);
Parámetros
- varBookmark
Una referencia a un objeto de CDBVariant que contiene el valor de marcador para un registro concreto.
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 SetBookmark producirá una excepción que produce.Los marcadores no se admiten en conjuntos de registros sólo hacia delante.
A primero recupere el marcador para el registro actual, la llamada GetBookmark, que guarda el valor de marcador a un objeto de CDBVariant .Después, puede volver a ese registro llamando a SetBookmark mediante el valor guardado del marcador.
[!NOTA]
Después de ciertas operaciones de conjunto de registros, debe comprobar la persistencia de marcador antes de llamar a SetBookmark.Por ejemplo, si se recupera un marcador con GetBookmark y después llama Requery, el marcador haya dejado de ser válido.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