Dela via


Använda koncisa funktioner

Vissa ODBC-funktioner får implicit åtkomst till deskriptorer. Programskrivare kan hitta dem enklare än att anropa SQLSetDescField eller SQLGetDescField. Dessa funktioner kallas koncisa funktioner eftersom de utför ett antal funktioner, inklusive att ange eller hämta beskrivande fält. Vissa koncisa funktioner låter ett program ange eller hämta flera relaterade beskrivningsfält i ett enda funktionsanrop.

Koncisa funktioner kan anropas utan att först hämta ett deskriptorhandtag för användning som argument. Dessa funktioner fungerar med de beskrivande fält som är associerade med instruktionshandtaget som de anropas för.

De koncisa funktionerna SQLBindCol och SQLBindParameter binder en kolumn eller parameter genom att ange de beskrivande fält som motsvarar deras argument. Var och en av dessa funktioner utför fler uppgifter än att bara ange deskriptorer. SQLBindCol och SQLBindParameter ger en fullständig specifikation av bindningen av en datakolumn eller dynamisk parameter. Ett program kan dock ändra individuell information om en bindning genom att anropa SQLSetDescField eller SQLSetDescRec och kan helt binda en kolumn eller parameter genom att göra en serie lämpliga anrop till dessa funktioner.

De koncisa funktionerna SQLColAttribute, SQLDescribeCol, SQLDescribeParam, SQLNumParams och SQLNumResultCols hämtar värden i beskrivande fält.

SQLSetDescRec och SQLGetDescRec är koncisa funktioner som med ett anrop anger eller hämtar flera deskriptorfält som påverkar datatypen och lagringen av kolumn- eller parameterdata. SQLSetDescRec är ett effektivt sätt att ändra bindningen av kolumn- eller parameterdata i ett steg.

SQLSetStmtAttr och SQLGetStmtAttr fungerar i vissa fall som koncisa funktioner. (Se Beskrivningsfält.)