Compartilhar via


CDatabase::GetBookmarkPersistence

Chame essa função de membro para determinar a persistência de indicadores em um objeto Recordset depois de determinadas operações.

DWORD GetBookmarkPersistence( ) const;

Valor de retorno

Uma bitmask que identifica as operações através das quais persistem os indicadores em um objeto recordset. Para obter detalhes, consulte Observações.

Comentários

Por exemplo, se você chamar CRecordset::GetBookmark e chamar CRecordset::Requery, o indicador obtido a partir de GetBookmark pode não ser mais válido. Você deve chamar GetBookmarkPersistence antes de chamar CRecordset::SetBookmark.

A tabela a seguir lista os valores de bitmask que podem ser combinados para o valor retornado de GetBookmarkPersistence.

Valor de bitmask

Persistência de indicador

SQL_BP_CLOSE

Os indicadores são válidos após uma operação Repetir consulta.

SQL_BP_DELETE

O indicador de uma linha é válido depois da operação Excluir dessa linha.

SQL_BP_DROP

Os indicadores são válidos após uma operação Fechar.

SQL_BP_SCROLL

Os indicadores são válidos após uma operação Mover. Isso simplesmente identifica se os indicadores são compatíveis com o conjunto de registros, como retornado por CRecordset::CanBookmark.

SQL_BP_TRANSACTION

Os indicadores são válidos depois que uma transação é confirmada ou revertida.

SQL_BP_UPDATE

O indicador de uma linha é válido depois da operação Atualizar dessa linha.

SQL_BP_OTHER_HSTMT

Indicadores associados a um objeto recordset são válidos em um segundo conjunto de registros.

Para obter mais informações sobre este valor retornado, consulte a função ODBC API SQLGetInfo no Windows SDK. Para obter mais informações sobre os indicadores, consulte o artigo Recordset: Bookmarks and Absolute Positions (ODBC).

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe incorporadas

Gráfico da hierarquia

Classe CRecordset

CRecordset::CanBookmark

CRecordset::GetBookmark

CRecordset::SetBookmark