Použití stručných funkcí

Některé funkce ODBC získávají implicitní přístup k popisovačům. Autoři aplikací mohou shledávat pohodlnější než volání SQLSetDescField nebo SQLGetDescField. Tyto funkce se nazývají stručné funkce, protože provádějí řadu funkcí, včetně nastavení nebo získávání polí popisovače. Některé stručné funkce umožňují aplikaci nastavit nebo načíst několik souvisejících polí popisovače v jednom volání funkce.

Stručné funkce lze volat bez prvního načtení popisovače pro použití jako argumentu. Tyto funkce pracují s poli deskriptoru přidruženými k handle popisovače příkazu, na který jsou volány.

Stručné funkce SQLBindCol a SQLBindParameter sváže sloupec nebo parametr nastavením polí popisovače, které odpovídají jejich argumentům. Každá z těchto funkcí provádí více úloh než pouhé nastavení popisovačů. SQLBindCol a SQLBindParameter poskytují úplnou specifikaci vazby datového sloupce nebo dynamického parametru. Aplikace však může změnit jednotlivé podrobnosti vazby voláním SQLSetDescField nebo SQLSetDescRec a může zcela svázat sloupec nebo parametr provedením řady vhodných volání těchto funkcí.

Stručné funkce SQLColAttribute, SQLDescribeCol, SQLDescribeParam, SQLNumParams a SQLNumResultCols načítají hodnoty v polích popisovače.

SQLSetDescRec a SQLGetDescRec jsou stručné funkce, které při jednom volání nastavují nebo získávají více polí popisovače, která ovlivňují datový typ a úložiště dat sloupců nebo parametrů. SQLSetDescRec je efektivní způsob, jak změnit vazbu dat sloupce nebo parametrů v jednom kroku.

SQLSetStmtAttr a SQLGetStmtAttr v některých případech slouží jako stručné funkce. (Viz pole deskriptorů.)