Usando funções concisas

Algumas funções ODBC ganham acesso implícito a descritores. Os programadores de aplicações podem achá-los mais convenientes do que chamar SQLSetDescField ou SQLGetDescField. Estas funções são chamadas funções concisas porque desempenham várias funções, incluindo definir ou obter campos de descritores. Algumas funções concisas permitem que uma aplicação defina ou recupere vários campos de descritores relacionados numa única chamada de função.

Funções concisas podem ser chamadas sem antes recuperar um handle de descritor para usar como argumento. Estas funções funcionam com os campos de descrição associados ao handle da instrução onde são chamadas.

As funções concisas SQLBindCol e SQLBindParameter associam uma coluna ou parâmetro ao definir os campos de descrição que correspondem aos seus argumentos. Cada uma destas funções desempenha mais tarefas do que simplesmente definir descritores. SQLBindCol e SQLBindParameter fornecem uma especificação completa da ligação de uma coluna de dados ou parâmetro dinâmico. No entanto, uma aplicação pode alterar detalhes individuais de uma ligação chamando SQLSetDescField ou SQLSetDescRec e pode ligar completamente uma coluna ou parâmetro ao fazer uma série de chamadas adequadas a essas funções.

As funções concisas SQLColAttribute, SQLDescribeCol, SQLDescribeParam, SQLNumParams e SQLNumResultCols recuperam valores em campos de descritores.

SQLSetDescRec e SQLGetDescRec são funções concisas que, com uma chamada, definem ou obtêm múltiplos campos de descrição que afetam o tipo de dados e o armazenamento dos dados das colunas ou parâmetros. O SQLSetDescRec é uma forma eficaz de alterar a ligação de dados de colunas ou parâmetros num só passo.

SQLSetStmtAttr e SQLGetStmtAttr servem como funções concisas em alguns casos. (Ver Campos de Descritor.)