SQLSetConnectAttr (bibliothèque de curseurs)

Important

Cette fonctionnalité sera supprimée dans une version future de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Microsoft recommande d’utiliser la fonctionnalité de curseur du pilote.

Cette rubrique décrit l’utilisation de la fonction SQLSetConnectAttr dans la bibliothèque de curseurs. Pour obtenir des informations générales sur SQLSetConnectAttr, consultez Fonction SQLSetConnectAttr.

Une application appelle SQLSetConnectAttr avec l’attribut SQL_ATTR_ODBC_CURSORS pour spécifier si la bibliothèque de curseurs est toujours utilisée, utilisée si le pilote ne prend pas en charge les curseurs avec défilement ou si elle n’est jamais utilisée. La bibliothèque de curseurs suppose qu’un pilote prend en charge les curseurs avec défilement s’il retourne SQL_CA1_RELATIVE pour le type d’informations SQL_STATIC_CURSOR_ATTRIBUTES1 dans SQLGetInfo.

L’application doit appeler SQLSetConnectAttr pour spécifier l’utilisation de la bibliothèque de curseurs après avoir appelé SQLAllocHandle avec un HandleType de SQL_HANDLE_DBC pour allouer la connexion et avant qu’elle ne se connecte à la source de données. Si une application appelle SQLSetConnectAttr avec l’attribut SQL_ATTR_ODBC_CURSORS alors que la connexion est toujours active, la bibliothèque de curseurs retourne une erreur.

Pour définir un attribut d’instruction pris en charge par la bibliothèque de curseurs pour toutes les instructions associées à une connexion, une application doit appeler SQLSetConnectAttr pour cet attribut d’instruction après s’être connectée à la source de données et avant d’ouvrir le curseur. Si une application appelle SQLSetConnectAttr avec un attribut d’instruction et qu’un curseur est ouvert sur une instruction associée à la connexion, l’attribut d’instruction n’est pas appliqué à cette instruction tant que le curseur n’est pas fermé et rouvert.