Использование кратких функций

Некоторые функции ODBC получают неявный доступ к дескрипторам. Разработчики приложений могут считать их более удобными, чем вызов SQLSetDescField или SQLGetDescField. Эти функции называются краткими , так как они выполняют ряд функций, включая настройку или получение полей дескриптора. Некоторые лаконичные функции позволяют приложению установить или получить несколько связанных полей дескриптора в одном вызове функции.

Краткие функции можно вызывать без первого извлечения дескриптора для использования в качестве аргумента. Эти функции работают с полями дескриптора, связанными с обработчиком SQL-запроса, на которые они вызываются.

Краткие функции SQLBindCol и SQLBindParameter привязывают столбец или параметр, задав поля дескриптора, соответствующие их аргументам. Каждая из этих функций выполняет больше задач, чем просто задает дескрипторы. SQLBindCol и SQLBindParameter предоставляют полную спецификацию привязки столбца данных или динамического параметра. Однако приложение может изменять отдельные сведения о привязке путем вызова SQLSetDescField или SQLSetDescRec и полностью привязать столбец или параметр, выполнив ряд подходящих вызовов этих функций.

Краткие функции SQLColAttribute, SQLDescribeCol, SQLDescribeParam, SQLNumParams и SQLNumResultCols извлекают значения в полях дескриптора.

SQLSetDescRec и SQLGetDescRec — это краткие функции, которые при одном вызове, настройке или получении нескольких полей дескриптора, влияющих на тип данных и хранение данных столбца или параметра. SQLSetDescRec — эффективный способ изменения привязки данных столбца или параметра на одном шаге.

SQLSetStmtAttr и SQLGetStmtAttr служат краткими функциями в некоторых случаях. (См. дескриптор поля.)