Compartilhar via

Usar a biblioteca de cursores ODBC

  • Artigo

Importante

Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A Microsoft recomenda usar a funcionalidade de cursor do driver.

Para usar a biblioteca de cursores ODBC, um aplicativo:

  1. Chama SQLSetConnectAttr com um atributo de SQL_ATTR_ODBC_CURSORS para especificar como a biblioteca de cursores deve ser usada com uma conexão específica. A biblioteca de cursores pode ser sempre usada (SQL_CUR_USE_ODBC), usada somente se o driver não oferecer suporte a cursores roláveis (SQL_CUR_USE_IF_NEEDED) ou nunca usado (SQL_CUR_USE_DRIVER).

  2. Chama SQLConnect, SQLDriverConnect ou SQLBrowseConnect para se conectar à fonte de dados.

  3. Chama SQLSetStmtAttr para especificar o tipo de cursor (SQL_ATTR_CURSOR_TYPE), a simultaneidade (SQL_ATTR_CONCURRENCY) e o tamanho do conjunto de linhas (SQL_ATTR_ROW_ARRAY_SIZE). A biblioteca de cursores dá suporte a cursores estáticos e somente encaminhamento. Os cursores somente de avanço devem ser somente leitura, enquanto os cursores estáticos podem ser somente leitura ou podem usar o controle de simultaneidade otimista comparando valores.

  4. Aloca um ou mais buffers de conjunto de linhas e chama SQLBindCol uma ou mais vezes para associar esses buffers a colunas do conjunto de resultados.

  5. Gera um conjunto de resultados executando uma instrução SELECT ou um procedimento ou chamando uma função de catálogo. Se o aplicativo executar instruções de atualização posicionadas, ele deverá executar uma instrução SELECT FOR UPDATE para gerar o conjunto de resultados.

  6. Chama SQLFetch ou SQLFetchScroll uma ou mais vezes para rolar pelo conjunto de resultados.

O aplicativo pode alterar os valores de dados nos buffers de conjunto de linhas. Para atualizar os buffers de conjunto de linhas com dados do cache da biblioteca de cursores, um aplicativo chama SQLFetchScroll com o argumento FetchOrientation definido como SQL_FETCH_RELATIVE e o argumento FetchOffset definido como 0.

Para recuperar dados de uma coluna não associada, o aplicativo chama SQLSetPos para posicionar o cursor na linha desejada. Em seguida, ele chama SQLGetData para recuperar os dados.

Para determinar o número de linhas que foram recuperadas da fonte de dados, o aplicativo chama SQLRowCount.