Umgebungshandles

Eine Umgebung ist ein globaler Kontext, in dem auf Daten zugegriffen werden kann; in Verbindung mit einer Umgebung sind alle Informationen, die global sind, z. B.:

• Der Zustand der Umgebung

• Die aktuelle Diagnose auf Umgebungsebene

• Die aktuell in der Umgebung zugewiesenen Verbindungsgriffe

• Die aktuellen Einstellungen der einzelnen Umgebungsattribute

Innerhalb eines Codeabschnitts, der ODBC (den Treiber-Manager oder einen Treiber) implementiert, identifiziert ein Umgebungshandle eine Struktur, die diese Informationen enthält.

Umgebungshandles werden in ODBC-Anwendungen nicht häufig verwendet. Sie werden immer in Aufrufen von SQLDataSources und SQLDrivers verwendet und manchmal in Aufrufen von SQLAllocHandle, SQLEndTran, SQLFreeHandle, SQLGetDiagField und SQLGetDiagRec verwendet.

Jeder Codeabschnitt, der ODBC (Treiber-Manager oder Treiber) implementiert, enthält einen oder mehrere Umgebungshandles. Beispielsweise verwaltet der Treiber-Manager ein separates Umgebungshandle für jede Anwendung, die mit ihm verbunden ist. Umgebungshandles werden sqlAllocHandle zugeordnet und mit SQLFreeHandle freigegeben.