SQLBindCol (bibliothèque de curseurs)
Important
Cette fonctionnalité sera supprimée dans une version future de Windows. Évitez d’utiliser cette fonctionnalité dans les nouveaux travaux 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 SQLBindCol dans la bibliothèque de curseurs. Pour plus d’informations générales sur SQLBindCol, consultez Fonction SQLBindCol.
Une application alloue une ou plusieurs mémoires tampons pour que la bibliothèque de curseurs retourne l’ensemble de lignes actuel dans. Il appelle SQLBindCol une ou plusieurs fois pour lier ces mémoires tampons au jeu de résultats.
Une application peut appeler SQLBindCol pour lier des colonnes de jeu de résultats après avoir appelé SQLExtendedFetch, SQLFetch ou SQLFetchScroll, tant que le type de données C, la taille de colonne et les chiffres décimaux de la colonne liée restent les mêmes. L’application n’a pas besoin de fermer le curseur pour lier des colonnes à différentes adresses.
La bibliothèque de curseurs prend en charge la définition de l’attribut d’instruction SQL_ATTR_ROW_BIND_OFFSET_PTR pour utiliser des décalages de liaison. (SQLBindCol n’a pas besoin d’être appelé pour que cette liaison se produise.) Si la bibliothèque de curseurs est utilisée avec un pilote ODBC 3.x , le décalage de liaison n’est pas utilisé lorsque SQLFetch est appelé. Le décalage de liaison est utilisé si SQLFetch est appelé lorsque la bibliothèque de curseurs est utilisée avec un pilote ODBC 2.x , car SQLFetch est ensuite mappé à SQLExtendedFetch.
La bibliothèque de curseurs prend en charge l’appel de SQLBindCol pour lier la colonne signet.
Lors de l’utilisation d’un pilote ODBC 2.x , la bibliothèque de curseurs renvoie SQLSTATE HY090 (chaîne ou longueur de mémoire tampon non valide) lorsque SQLBindCol est appelé pour définir la longueur de la mémoire tampon d’une colonne de signet sur une valeur non égale à 4. Lors de l’utilisation d’un pilote ODBC 3.x , la bibliothèque de curseurs autorise la mémoire tampon à n’importe quelle taille.