void SetBookm&ark (const CDBVariantamp; varBookmark );
lançar (CDBException, CMemoryException);
Parâmetros
varBookmark
Uma referência a um objeto CDBVariant que contém o valor do indicador de um registro específico.
Observações
Chame essa função de membro para posicionar o conjunto de registros no registro que contém o indicador especificado. 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, chamada SetBookmark resultará em uma exceção sendo lançada. Indicadores não são suportados em conjuntos de registros somente de avançar.
Primeiro recuperar o indicador do registro atual, chame GetBookmark, que salva o valor do indicador para um objeto CDBVariant . Mais tarde, você pode retornar a esse registro chamando SetBookmark usando o valor do indicador salvo.
&Notanbsp; Após determinadas operações de conjunto de registros, você deve verificar a persistência de marcador antes de chamar SetBookmark. Por exemplo, se você recuperar um indicador com GetBookmark e, em seguida, chamar RepetirConsulta, o indicador já não pode ser válido. 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::GetBookmark, CRecordset::SetAbsolutePosition, CDatabase::GetBookmarkPersistence