Korzystanie z funkcji zwięzłych

Niektóre funkcje ODBC uzyskują niejawny dostęp do deskryptorów. Autorzy aplikacji mogą znaleźć je wygodniejsze niż wywoływanie sqlSetDescField lub SQLGetDescField. Te funkcje są nazywane zwięzłymi funkcjami, ponieważ wykonują szereg funkcji, w tym ustawianie lub pobieranie pól deskryptora. Niektóre zwięzłe funkcje umożliwiają aplikacji ustawianie lub pobieranie kilku powiązanych pól deskryptora w jednym wywołaniu funkcji.

Funkcje zwięzłe można wywoływać bez uprzedniego pobierania uchwytu deskryptora do użycia jako argumentu. Te funkcje działają z polami deskryptora skojarzonymi z uchwytem instrukcji, na którym są wywoływane.

Zwięzłe funkcje SQLBindCol i SQLBindParameter wiążą kolumnę lub parametr przez ustawienie pól deskryptora odpowiadających ich argumentom. Każda z tych funkcji wykonuje więcej zadań niż po prostu ustawianie deskryptorów. Klasy SQLBindCol i SQLBindParameter zapewniają pełną specyfikację powiązania kolumny danych lub parametru dynamicznego. Aplikacja może jednak zmienić poszczególne szczegóły powiązania przez wywołanie metody SQLSetDescField lub SQLSetDescRec i może całkowicie powiązać kolumnę lub parametr, tworząc serię odpowiednich wywołań do tych funkcji.

Zwięzłe funkcje SQLColAttribute, SQLDescribeCol, SQLDescribeParam, SQLNumParams i SQLNumResultCols pobierają wartości w polach deskryptora.

SqlSetDescRec i SQLGetDescRec to zwięzłe funkcje, które z jednym wywołaniem ustawiają lub pobierają wiele pól deskryptora mających wpływ na typ danych i przechowywanie danych kolumn lub parametrów. SQLSetDescRec to skuteczny sposób zmiany powiązania danych kolumny lub parametrów w jednym kroku.

SqlSetStmtAttr i SQLGetStmtAttr pełnią w niektórych przypadkach funkcję zwięzłą. (Zobacz Pola deskryptora).