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çãoObservaçã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çãoObservaçã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

Consulte também

Referência

Classe de CRecordset

Gráfico de hierarquia

CRecordset::CanBookmark

CRecordset::SetBookmark

CDatabase::GetBookmarkPersistence