Usar funções concisas

Algumas funções ODBC obtêm acesso implícito a descritores. Quem escreve aplicativos pode considerar isso mais conveniente do que chamar SQLSetDescField ou SQLGetDescField. Essas funções são chamadas de funções concisas porque executam uma série de funções, incluindo definir ou obter campos descritores. Algumas funções concisas permitem que um aplicativo defina ou recupere vários campos de descritores relacionados em uma só chamada de função.

Funções concisas podem ser chamadas sem primeiro recuperar um identificador do descritor para uso como um argumento. Essas funções operam com os campos descritores associados ao identificador de instrução no qual são chamadas.

As funções concisas SQLBindCol e SQLBindParameter vinculam uma coluna ou parâmetro definindo os campos descritores que correspondem aos seus argumentos. Cada uma dessas funções executa mais tarefas do que apenas definir descritores. SQLBindCol e SQLBindParameter oferecem uma especificação completa da associação de uma coluna de dados ou parâmetro dinâmico. Porém, um aplicativo pode alterar detalhes individuais de uma associação chamando SQLSetDescField ou SQLSetDescRec e pode vincular completamente uma coluna ou parâmetro fazendo uma série de chamadas adequadas para essas funções.

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

SQLSetDescRec e SQLGetDescRec são funções concisas que, com uma chamada, definem ou obtêm vários campos descritores que afetam o tipo de dados e o armazenamento de dados de coluna ou parâmetro. SQLSetDescRec é um modo 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. (Confira Campos de descritor.)