Como recuperar linhas usando indicadores (OLE DB)

O consumidor define o valor de campo dwFlag da estrutura associada como DBCOLUMNSINFO_ISBOOKMARK para indicar que a coluna é usada como um indicador. O consumidor também define a propriedade DBPROP_BOOKMARKS do conjunto de linhas como VARIANT_TRUE. Isso permite que a coluna 0 esteja presente no conjunto de linhas. Então, IRowsetLocate::GetRowsAt é usado para buscar linhas, começando com a linha especificada como um deslocamento de um indicador.

Um exemplo completo mostra como buscar linhas usando um indicador. O código de exemplo completo se encontra no arquivo GetRowsUsingBookmark.cpp. Você pode baixar um arquivo que contém o exemplo da página de Downloads do SQL Server no MSDN. Nesse exemplo, a quinta linha é recuperada do conjunto de resultados gerado pela execução de uma instrução SELECT.

Esse exemplo foi desenvolvido com o Microsoft Visual C++ 2005.

Observação sobre segurança
Quando possível, use a Autenticação do Windows. Se a Autenticação do Windows não estiver disponível, solicite aos usuários que digitem suas credenciais em tempo de execução. Evite armazenar as credenciais em um arquivo. Se for necessário manter as credenciais, criptografe-as com a API de criptografia Win32.

Para recuperar linhas usando indicadores

1. Estabeleça uma conexão com a fonte de dados.

2. Defina a propriedade DBPROP_IRowsetLocate do conjunto de linhas como VARIANT_TRUE.

3. Execute o comando.

4. Defina o campo dwFlag da estrutura associada como o sinalizador DBCOLUMNSINFO_ISBOOKMARK para a coluna que será usada como indicador.

5. Use IRowsetLocate::GetRowsAt para buscar linhas, iniciando com a linha especificada por um deslocamento do indicador.