Usar cursores em bloco

O suporte para cursores em bloco está integrado ao ODBC 3.x. SQLFetch pode ser usado somente para buscas de várias linhas quando chamado no ODBC 3.x; se um aplicativo ODBC 2.x chamar SQLFetch, ele abrirá apenas um cursor de somente avanço de linha única. Quando um aplicativo ODBC 3.x chama SQLFetch em um driver ODBC 2.x, ele retorna uma única linha, a menos que o driver dê suporte a SQLExtendedFetch. Para obter mais informações, consulte Cursores em bloco, cursores roláveis e compatibilidade com versões anteriores no Apêndice G: diretrizes de driver para compatibilidade com versões anteriores.

Para usar cursores em bloco, o aplicativo define o tamanho do conjunto de linhas, vincula os buffers do conjunto de linhas (conforme descrito na seção anterior), define opcionalmente os atributos de instrução SQL_ATTR_ROWS_FETCHED_PTR e SQL_ATTR_ROW_STATUS_PTR e chama SQLFetch ou SQLFetchScroll para buscar um bloco de linhas. O aplicativo pode alterar o tamanho do conjunto de linhas e vincular novos buffers de conjunto de linhas (chamando SQLBindCol ou especificando um deslocamento de associação) mesmo depois que as linhas forem buscadas.

Esta seção contém os tópicos a seguir.