void GetBookm&ark (CDBVariantamp; varBookmark );
lançar (CDBException, CMemoryException);
Parâmetros
varBookmark
Uma referência a um objeto de CDBVariant representando o indicador no registro atual.
Observações
Chame essa função de membro para obter o valor do indicador para o registro atual. Para determinar se os indicadores são suportados no conjunto de registros, chame CanBookmark. Para disponibilizar indicadores se forem suportados, você deve definir a opção useBookmarks no parâmetro dwOptions da função de membro Abrir.
&Notanbsp; Se indicadores são sem suporte ou indisponível, chamar GetBookmark resultará em uma exceção sendo lançada. Indicadores não são suportados em conjuntos de registros somente de avançar.
GetBookmark atribui o valor do indicador para o registro atual para um objeto CDBVariant . Para retornar a esse registro a qualquer momento depois de mover para um registro diferente, chame SetBookmark com o objeto CDBVariant correspondente.
&Notanbsp; Após determinadas operações de conjunto de registros, indicadores podem já não ser válidas. Por exemplo, se você chamar GetBookmark seguido RepetirConsulta, você pode não ser capaz de retornar para o registro com SetBookmark. Chamada CDatabase::GetBookmarkPersistence para verificar se você pode chamar com segurança SetBookmark.
Para obter mais informações sobre indicadores e navegação do conjunto de registros, consulte os artigos Recordset: indicadores e absoluto posições (ODBC) e Recordset: rolagem (ODBC) no Guia do programador do Visual C++.
Visão geral de CRecordset | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CRecordset::CanBookmark, CRecordset::SetBookmark, CDatabase::GetBookmarkPersistence