Usando funções concisas

Algumas funções ODBC obtêm acesso implícito a descritores. Desenvolvedores de aplicativos podem achá-los mais convenientes do que chamar SQLSetDescField ou SQLGetDescField. Essas funções são chamadas de funções concisas porque executam várias funções, incluindo a configuração ou a obtenção de campos descritores. Algumas funções concisas permitem que um aplicativo defina ou recupere vários campos de descritor relacionados em uma única chamada de função.

As funções concisas podem ser chamadas sem primeiro recuperar um identificador de descritor para uso como argumento. Essas funções funcionam com os campos de descritor associados ao identificador de declaração nos quais são chamadas.

As funções concisas SQLBindCol e SQLBindParameter associam uma coluna ou parâmetro definindo os campos do descritor que correspondem aos argumentos. Cada uma dessas funções executa mais tarefas do que simplesmente definir descritores. SQLBindCol e SQLBindParameter fornecem uma especificação completa da associação de uma coluna de dados ou parâmetro dinâmico. No entanto, um aplicativo pode alterar detalhes individuais de uma associação chamando SQLSetDescField ou SQLSetDescRec e pode associar completamente uma coluna ou parâmetro fazendo 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 descritor.

SQLSetDescRec e SQLGetDescRec são funções concisas que, com uma chamada, definem ou obtêm vários campos de descritor que afetam o tipo de dados e o armazenamento de dados de coluna ou parâmetro. SQLSetDescRec é uma maneira eficaz de alterar a associação de dados de coluna ou parâmetro em uma etapa.

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