Anslutningshandtag

En anslutning består av en drivrutin och en datakälla. En anslutningsreferens identifierar varje anslutning. Anslutningshandtaget definierar inte bara vilken drivrutin som ska användas utan vilken datakälla som ska användas med drivrutinen. Inom ett kodsegment som implementerar ODBC (drivrutinshanteraren eller en drivrutin) identifierar anslutningshandtaget en struktur som innehåller anslutningsinformation, till exempel följande:

• Tillståndet för anslutningen

• Den aktuella diagnostiken på anslutningsnivå

• Handtag för satser och deskriptorer som för närvarande allokeras för anslutningen

• De aktuella inställningarna för varje anslutningsattribut

ODBC förhindrar inte flera samtidiga anslutningar om drivrutinen stöder dem. I en viss ODBC-miljö kan därför flera anslutningsreferenser peka på en mängd olika drivrutiner och datakällor, till samma drivrutin och en mängd olika datakällor, eller till och med till flera anslutningar till samma drivrutin och datakälla. Vissa drivrutiner begränsar antalet aktiva anslutningar som de stöder. alternativet SQL_MAX_DRIVER_CONNECTIONS i SQLGetInfo anger hur många aktiva anslutningar en viss drivrutin stöder.

Anslutningsreferenser används främst vid anslutning till datakällan (SQLConnect, SQLDriverConnect eller SQLBrowseConnect), frånkoppling från datakällan (SQLDisconnect), hämtar information om drivrutinen och datakällan (SQLGetInfo), hämtar diagnostik (SQLGetDiagField och SQLGetDiagRec) och utför transaktioner (SQLEndTran). De används också när du ställer in och hämtar anslutningsattribut (SQLSetConnectAttr och SQLGetConnectAttr) och när du hämtar det interna formatet för en SQL-instruktion (SQLNativeSql).

Anslutningshandtag allokeras med SQLAllocHandle och frigörs med SQLFreeHandle.