Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Une application peut affecter un stockage pour les résultats avant ou après l’exécution d’une instruction SQL. Si une application prépare ou exécute d’abord l’instruction SQL, elle peut se renseigner sur le jeu de résultats avant d’affecter le stockage pour les résultats. Par exemple, si le jeu de résultats est inconnu, l’application doit récupérer le nombre de colonnes avant qu’elle puisse leur attribuer du stockage.
Pour associer le stockage pour une colonne de données, une application appelle SQLBindColet la transmet :
Type de données vers lequel les données doivent être converties.
Adresse d’une mémoire tampon de sortie pour les données.
L’application doit allouer cette mémoire tampon, et elle doit être suffisamment grande pour contenir les données dans le formulaire dans lequel elle est convertie.
Longueur de la mémoire tampon de sortie.
Cette valeur est ignorée si les données retournées ont une largeur fixe en C, telle qu’un entier, un nombre réel ou une structure de date.
Adresse d’une mémoire tampon de stockage dans laquelle retourner le nombre d’octets de données disponibles.
Une application peut également lier des colonnes de jeu de résultats à des tableaux de variables de programme pour prendre en charge l’extraction de lignes de jeu de résultats dans des blocs. Il existe deux types de liaison de tableau différents :
La liaison à l’échelle des colonnes est terminée lorsque chaque colonne est liée à son propre tableau de variables.
La liaison à l’échelle des colonnes est spécifiée en appelant SQLSetStmtAttr avec l’attribut défini sur SQL_ATTR_ROW_BIND_TYPE et ValuePtr défini sur SQL_BIND_BY_COLUMN. Tous les tableaux doivent avoir le même nombre d’éléments.
La liaison au niveau des lignes est terminée lorsque tous les paramètres de l’instruction SQL sont liés sous forme d’unité à un tableau de structures qui contiennent les variables individuelles des paramètres.
La liaison au niveau des lignes est spécifiée en appelant SQLSetStmtAttr avec l’attribut défini sur SQL_ATTR_ROW_BIND_TYPE et ValuePtr défini sur la taille de la structure contenant les variables qui recevront les colonnes du jeu de résultats.
L’application définit également SQL_ATTR_ROW_ARRAY_SIZE le nombre d’éléments dans les tableaux de colonnes ou de lignes et définit SQL_ATTR_ROW_STATUS_PTR et SQL_ATTR_ROWS_FETCHED_PTR.