Utsagahanterare

En instruktion är lättast att betrakta som en SQL-instruktion, till exempel SELECT * FROM Employee. En -instruktion är dock mer än bara en SQL-instruktion – den består av all information som är associerad med SQL-instruktionen, till exempel eventuella resultatuppsättningar som skapats av -instruktionen och parametrarna som används vid körningen av -instruktionen. En instruktion behöver inte ens ha en programdefinierad SQL-instruktion. När till exempel en katalogfunktion som SQLTables körs på en -instruktion, kör den en fördefinierad SQL-instruktion som returnerar en lista med tabellnamn.

Varje anrop identifieras av ett anropshandtag. En sats är kopplad till en enda anslutning, och det kan finnas flera satser på den anslutningen. Vissa drivrutiner begränsar antalet aktiva instruktioner som de stöder. alternativet SQL_MAX_CONCURRENT_ACTIVITIES i SQLGetInfo anger hur många aktiva instruktioner en drivrutin stöder på en enda anslutning. En instruktion definieras som aktiv om den har väntande resultat, där resultatet antingen är en resultatuppsättning eller antalet rader som påverkas av en INSERT-, UPDATE- eller DELETE-instruktion eller data skickas med flera anrop till SQLPutData.

I en kod som implementerar ODBC (Driver Manager eller en drivrutin) identifierar instruktionshandtaget en struktur som innehåller instruktionsinformation, till exempel:

• Uttalandets status

• Aktuell diagnostik på utsagnsnivå

• Adresserna för programvariablerna som är bundna till instruktionens parametrar och resultatuppsättningskolumner

• De aktuella inställningarna för varje instruktionsattribut

Utsagningshandtag används i de flesta ODBC-funktioner. I synnerhet används de i funktionerna för att binda parametrar och resultatuppsättningskolumner (SQLBindParameter och SQLBindCol), förbereda och köra instruktioner (SQLPrepare, SQLExecute och SQLExecDirect), hämta metadata (SQLColAttribute och SQLDescribeCol), hämta resultat (SQLFetch) och hämta diagnostik (SQLGetDiagField och SQLGetDiagRec). De används också i katalogfunktioner (SQLColumns, SQLTables och så vidare) och ett antal andra funktioner.

Uttalandehandtag allokeras med SQLAllocHandle och frigörs med SQLFreeHandle.