Uso de funciones concisas

Algunas funciones ODBC obtienen acceso implícito a los descriptores. Los escritores de aplicaciones pueden encontrarlos más convenientes que llamar a SQLSetDescField o SQLGetDescField. Estas funciones se denominan funciones concisas porque realizan una serie de funciones, incluidos los campos de configuración o obtención de descriptores. Algunas funciones concisas permiten que un conjunto de aplicaciones o recupere varios campos descriptores relacionados en una sola llamada de función.

Se puede llamar a funciones concisas sin recuperar primero un identificador de descriptor para su uso como argumento. Estas funciones funcionan con los campos descriptores asociados al identificador de instrucción en el que se llama.

Las funciones concisas SQLBindCol y SQLBindParameter enlazan una columna o parámetro estableciendo los campos descriptores que corresponden a sus argumentos. Cada una de estas funciones realiza más tareas que simplemente establecer descriptores. SQLBindCol y SQLBindParameter proporcionan una especificación completa del enlace de una columna de datos o un parámetro dinámico. Sin embargo, una aplicación puede cambiar los detalles individuales de un enlace llamando a SQLSetDescField o SQLSetDescRec y puede enlazar completamente una columna o parámetro realizando una serie de llamadas adecuadas a estas funciones.

Las funciones concisas SQLColAttribute, SQLDescribeCol, SQLDescribeParam, SQLNumParams y SQLNumResultCols recuperan valores en campos descriptores.

SQLSetDescRec y SQLGetDescRec son funciones concisas que, con una llamada, establecer o obtener varios campos descriptores que afectan al tipo de datos y al almacenamiento de datos de columna o parámetro. SQLSetDescRec es una manera eficaz de cambiar el enlace de datos de columnas o parámetros en un paso.

SQLSetStmtAttr y SQLGetStmtAttr sirven como funciones concisas en algunos casos. (Consulte Campos descriptores.)