CRecordset::SetBookmark

Artigo
08/25/2010

Posiciona o conjunto de registros no registro que contém o indicador especificado.

void SetBookmark( 
   const CDBVariant& varBookmark  
);

Parâmetros

varBookmark
Uma referência a um CDBVariant objeto que contém o valor do indicador de um registro específico.

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 .

Observação:
Se forem marcadores sem suporte ou não estiver disponível, chamando SetBookmark resultará em uma exceção sendo lançada. Indicadores não são suportados em conjuntos de registros somente de encaminhar.

Para recuperar o indicador para o registro corrente, primeiro telefonar GetBookmark, que salva o valor do indicador para um CDBVariant objeto. Posteriormente, você pode retornar a esse registro chamando SetBookmark usando o valor do indicador salvo.

Observação:
Depois de determinadas operações de conjunto de registros, você deve verificar a persistência do indicador antes de ligar SetBookmark.Por exemplo, se você recuperar um indicador com GetBookmark e, em seguida telefonar Repetir a consulta, o indicador pode não ser válido. De telefonarCDatabase::GetBookmarkPersistence para verificar se é possível chamar com segurança SetBookmark.

Depois de determinadas operações de conjunto de registros, você deve verificar a persistência do indicador antes de ligar SetBookmark.Por exemplo, se você recuperar um indicador com GetBookmark e, em seguida telefonar Repetir a consulta, o indicador pode não ser válido. 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.