SQLSetConnectAttr (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 SQLSetConnectAttr na biblioteca de cursores. Para obter informações gerais sobre SQLSetConnectAttr, consulte Função SQLSetConnectAttr.

Um aplicativo chama SQLSetConnectAttr com o atributo SQL_ATTR_ODBC_CURSORS para especificar se a biblioteca de cursores é sempre usada, usada se o driver não dá suporte a cursores roláveis ou nunca é usado. A biblioteca de cursores pressupõe que um driver dê suporte a cursores roláveis se retornar SQL_CA1_RELATIVE para o tipo de informações SQL_STATIC_CURSOR_ATTRIBUTES1 no SQLGetInfo.

O aplicativo deve chamar SQLSetConnectAttr para especificar o uso da biblioteca de cursores depois de chamar SQLAllocHandle com um HandleType de SQL_HANDLE_DBC para alocar a conexão e antes de se conectar à fonte de dados. Se um aplicativo chamar SQLSetConnectAttr com o atributo SQL_ATTR_ODBC_CURSORS enquanto a conexão ainda estiver ativa, a biblioteca de cursores retornará um erro.

Para definir um atributo de instrução com suporte pela biblioteca de cursores para todas as instruções associadas a uma conexão, um aplicativo deve chamar SQLSetConnectAttr para esse atributo de instrução depois de se conectar à fonte de dados e antes de abrir o cursor. Se um aplicativo chamar SQLSetConnectAttr com um atributo de instrução e um cursor estiver aberto em uma instrução associada à conexão, o atributo de instrução não será aplicado a essa instrução até que o cursor seja fechado e reaberto.