CRecordset::GetBookmark
Obtém o valor do indicador para o registro corrente.
void GetBookmark(
CDBVariant& varBookmark
);
Parâmetros
- varBookmark
Uma referência a um CDBVariant objeto que representa o indicador no registro corrente.
Comentários
Para determinar se os marcadores são suportados no conjunto de registros, telefonar CanBookmark.Para disponibilizar indicadores se houver suporte para, você deve conjunto o CRecordset::useBookmarks opção de a dwOptions parâmetro das em abertofunção de membro .
.gif "Observação") Observação: |
|---|
Se forem marcadores sem suporte ou não estiver disponível, chamando GetBookmark resultará em uma exceção sendo lançada. Indicadores não são suportados em conjuntos de registros somente de encaminhar. |
GetBookmark atribui o valor do indicador para o registro corrente para um CDBVariant objeto. Para retornar a esse registro a qualquer momento depois de mover para um registro diferente, telefonar SetBookmark com o correspondente CDBVariant objeto.
| Observação: |
|---|
Depois de determinadas operações de conjunto de registros, marcadores podem não estar mais válido.Por exemplo, se você chamar GetBookmark seguido por Repetir a consulta, talvez não seja possível retornar para o registro com SetBookmark. De telefonarCDatabase::GetBookmarkPersistence para verificar se é possível chamar com segurança SetBookmark. |
Para obter mais informações sobre indicadores e navegação do conjunto de registros, consulte o artigo Recordset: Indicadores e posições absolutas (ODBC) e conjunto de registros: (ODBC) de rolagem.
Exceções
Esse método pode lançar exceções do tipo CDBException * and CMemoryException*.
Requisitos
Cabeçalho: afxdb.h
Consulte também
Referência
CDatabase::GetBookmarkPersistence