Utilisation de fonctions concises

Certaines fonctions ODBC obtiennent un accès implicite aux descripteurs. Les enregistreurs d’applications peuvent les trouver plus pratiques que d’appeler SQLSetDescField ou SQLGetDescField. Ces fonctions sont appelées fonctions concises , car elles exécutent un certain nombre de fonctions, notamment la définition ou l’obtention de champs de descripteur. Certaines fonctions concises permettent à une application de définir ou de récupérer plusieurs champs de descripteur associés dans un seul appel de fonction.

Les fonctions concises peuvent être appelées sans récupérer d’abord un handle de descripteur pour une utilisation en tant qu’argument. Ces fonctions fonctionnent avec les champs de descripteur associés au handle d’instruction sur lequel elles sont appelées.

Les fonctions concises SQLBindCol et SQLBindParameter lient une colonne ou un paramètre en définissant les champs de descripteur correspondant à leurs arguments. Chacune de ces fonctions effectue plus de tâches que de définir simplement des descripteurs. SQLBindCol et SQLBindParameter fournissent une spécification complète de la liaison d’une colonne de données ou d’un paramètre dynamique. Toutefois, une application peut modifier les détails individuels d’une liaison en appelant SQLSetDescField ou SQLSetDescRec et peut lier complètement une colonne ou un paramètre en effectuant une série d’appels appropriés à ces fonctions.

Les fonctions concises SQLColAttribute, SQLDescribeCol, SQLDescribeParam, SQLNumParams et SQLNumResultCols récupèrent des valeurs dans les champs de descripteur.

SQLSetDescRec et SQLGetDescRec sont des fonctions concises qui, avec un appel, définissent ou obtiennent plusieurs champs descripteur qui affectent le type de données et le stockage des données de colonne ou de paramètre. SQLSetDescRec est un moyen efficace de modifier la liaison de données de colonne ou de paramètre en une seule étape.

SQLSetStmtAttr et SQLGetStmtAttr servent de fonctions concises dans certains cas. (Voir Champs de descripteur.)