SQLFetch (Biblioteca de cursores)

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.

Este tópico discute o uso da função SQLFetch na biblioteca de cursores. Para obter informações gerais sobre SQLFetch, consulte Função SQLFetch.

Quando a biblioteca de cursores é usada, as chamadas para SQLFetch não podem ser misturadas com chamadas para SQLFetchScroll ou SQLExtendedFetch.

Se SQLFetch for chamado com SQL_ATTR_ROW_ARRAY_SIZE definido como um valor maior que 1, a biblioteca de cursores passará a chamada para o driver. Se o driver for um ODBC 2. x driver, o tamanho do conjunto de linhas será ignorado e a chamada para SQLFetch retornará uma única linha de dados.

Se a biblioteca de cursores for usada com um ODBC 2. x driver, um deslocamento de associação (conforme definido pelo atributo de instrução SQL_ATTR_ROW_BIND_OFFSET_PTR) não é usado quando SQLFetch é chamado.

Quando a biblioteca de cursores é carregada, um aplicativo não pode chamar SQLFetch para buscar colunas de indicador. A biblioteca de cursores passa a chamada para SQLFetch até o driver, mas as chamadas de função para habilitar indicadores e associar a coluna de indicador são interceptadas pela biblioteca de cursores.