CRecordset::GetBookmark

Artigo
02/25/2013

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.