CRecordset::GetBookmark
Obtém o valor do indexador para o registro atual.
void GetBookmark(
CDBVariant& varBookmark
);
Parâmetros
- varBookmark
Uma referência a um objeto de CDBVariant que representa o indexador no registro atual.
Comentários
Para determinar se os indicadores são suportados no conjunto de registros, CanBookmarkchamada. Para tornar disponíveis se indicadores são suportados, você deve definir a opção de CRecordset::useBookmarks no parâmetro de dwOptions da função de membro de Abrir .
Dica
Se os indicadores são sem suporte ou indisponível, chame GetBookmark resultará em uma exceção que está sendo lançada.Indexadores não são suportados em conjuntos de registros somente encaminhamentos.
GetBookmark atribui o valor do indexador para o registro atual a um objeto de CDBVariant . Para retornar a qualquer momento para esse registro após mudar para um registro diferente, chame SetBookmark com o objeto correspondente de CDBVariant .
Dica
Após certas operações de conjunto de registros, os indexadores podem não ser válido.Por exemplo, se você chamar GetBookmark seguido por Requery, você não poderá retornar ao registro com SetBookmark.Chame CDatabase::GetBookmarkPersistence para verificar se você possa chamar com segurança SetBookmark.
Para obter mais informações sobre configuração e navegação do conjunto de registros, consulte os artigos conjunto de registros: Indexadores e posições absolutas (ODBC) e conjunto de registros: Imprima (ODBC).
Exceções
Esse método pode lançar exceções do tipo CDBException* e CMemoryException*.
Requisitos
Cabeçalho: afxdb.h