SQLGetInfo (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 SQLGetInfo dans la bibliothèque de curseurs. Pour obtenir des informations générales sur SQLGetInfo, consultez Fonction SQLGetInfo.
La bibliothèque de curseurs retourne des valeurs pour les valeurs suivantes d’InfoType (| représente un OR au niveau du bit) ; pour toutes les autres valeurs d’InfoType, il appelle SQLGetInfo dans le pilote.
| InfoType | Valeur renvoyée |
|---|---|
| SQL_BOOKMARK_PERSISTENCE | SQL_BP_SCROLL |
| SQL_DYNAMIC_CURSOR_ATTRIBUTES1 | 0 |
| SQL_DYNAMIC_CURSOR_ATTRIBUTES2 | 0 |
| SQL_FETCH_DIRECTION[1] | SQL_FD_FETCH_ABSOLUTE | SQL_FD_FETCH_FIRST | SQL_FD_FETCH_LAST | SQL_FD_FETCH_NEXT | SQL_FD_FETCH_PRIOR | SQL_FD_FETCH_RELATIVE | SQL_FD_FETCH_BOOKMARK |
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1 | SQL_CA1_NEXT | SQL_CA1_ABSOLUTE | SQL_CA1_RELATIVE | SQL_CA1_LOCK_NO_CHANGE | SQL_CA1_POS_POSITION | SQL_CA1_POSITIONED_DELETE | SQL_CA1_POSITIONED_UPDATE | SQL_CA1_SELECT_FOR_UPDATE |
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2 | SQL_CA2_READ_ONLY_CONCUR | SQL_CA2_OPT_VALUES_CONCURRENCY | SQL_CA2_SENSITIVITY_UPDATES |
| SQL_GETDATA_EXTENSIONS | SQL_GD_BLOCK | toutes les valeurs retournées par le pilote Remarque : Lorsque des données sont récupérées avec SQLFetchScroll, SQLGetData prend en charge les fonctionnalités spécifiées avec les SQL_GD_ANY_COLUMN et les SQL_GD_BOUND masque de bits. |
| SQL_KEYSET_DRIVEN_CURSOR_ATTRIBUTES1 | 0 |
| SQL_KEYSET_DRIVEN_CURSOR_ATTRIBUTES2 | 0 |
| SQL_LOCK_TYPES[1] | SQL_LCK_NO_CHANGE |
| SQL_STATIC_CURSOR_ATTRIBUTES1 | SQL_CA1_NEXT | SQL_CA1_ABSOLUTE | SQL_CA1_RELATIVE | SQL_CA1_BOOKMARK | SQL_CA1_LOCK_NO_CHANGE | SQL_CA1_POS_POSITION | SQL_CA1_POSITIONED_DELETE | SQL_CA1_POSITIONED_UPDATE | SQL_CA1_SELECT_FOR_UPDATE |
| SQL_STATIC_CURSOR_ATTRIBUTES2 | SQL_CA2_READ_ONLY_CONCUR | SQL_CA2_OPT_VALUES_ CONCURRENCY | SQL_CA2_SENSITIVITY_UPDATES |
| SQL_POS_OPERATIONS[1] | SQL_POS_POSITION |
| SQL_POSITIONED_STATEMENTS[1] | SQL_PS_POSITIONED_DELETE | SQL_PS_POSITIONED_UPDATE | SQL_PS_SELECT_FOR_UPDATE |
| SQL_ROW_UPDATES | "Y" |
| SQL_SCROLL_CONCURRENCY[1] | SQL_SCCO_READ_ONLY | SQL_SCCO_OPT_VALUES |
| SQL_SCROLL_OPTIONS | SQL_SO_FORWARD_ONLY | SQL_SO_STATIC |
| SQL_STATIC_SENSITIVITY[1] | SQL_SS_UPDATES |
[1] Utilisé uniquement lorsque la bibliothèque de curseurs est utilisée avec un pilote ODBC 2.x.
Important
La bibliothèque de curseurs implémente le même comportement de curseur lorsque les transactions sont validées ou restaurées que la source de données. Autrement dit, la validation ou la restauration d’une transaction, soit en appelant SQLEndTran , soit en utilisant l’attribut de connexion SQL_ATTR_AUTOCOMMIT, peut entraîner la suppression des plans d’accès et la fermeture des curseurs pour toutes les instructions d’une connexion. Pour plus d’informations, consultez les types d’informations SQL_CURSOR_COMMIT_BEHAVIOR et SQL_CURSOR_ROLLBACK_BEHAVIOR dans SQLGetInfo.