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 .
Observação |
---|
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 .
Observação |
---|
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