Verbindungsübergänge
ODBC-Verbindungen weisen die folgenden Zustände auf.
| State | Beschreibung |
|---|---|
| C0 | Nicht zugewiesene Umgebung, nicht zugewiesene Verbindung |
| C1 | Zugeordnete Umgebung, nicht zugeordnete Verbindung |
| C2 | Zugeordnete Umgebung, zugeordnete Verbindung |
| C3 | Die Verbindungsfunktion benötigt Daten. |
| C4 | Verbundene Verbindung |
| C5 | Verbundene Verbindung, zugeordnete Anweisung |
| C6 | Verbundene Verbindung, Transaktion wird ausgeführt. Es ist möglich, dass sich eine Verbindung im Zustand C6 befindet und keine Anweisungen für die Verbindung zugeordnet sind. Angenommen, die Verbindung befindet sich im manuellen Commitmodus und befindet sich im Zustand C4. Wenn eine Anweisung zugewiesen, ausgeführt (eine Transaktion gestartet) und dann freigegeben wird, bleibt die Transaktion aktiv, aber es gibt keine Anweisungen für die Verbindung. |
In den folgenden Tabellen wird gezeigt, wie sich jede ODBC-Funktion auf den Verbindungsstatus auswirkt.
SQLAllocHandle
| C0 Kein Env. |
C1 Nicht zugewiesen | C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| C1[1] | --[5] | --[5] | --[5] | --[5] | --[5] | --[5] |
| (IH)[2] | C2 | --[5] | --[5] | --[5] | --[5] | --[5] |
| (IH)[3] | (IH) | (08003) | (08003) | C5 | --[5] | --[5] |
| (IH)[4] | (IH) | (08003) | (08003) | --[5] | --[5] | --[5] |
[1] Diese Zeile zeigt Übergänge an, als HandleType SQL_HANDLE_ENV wurde.
[2] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_DBC wurde.
[3] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_STMT wurde.
[4] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_DESC wurde.
[5] Aufrufen von SQLAllocHandle mit OutputHandlePtr , das auf ein gültiges Handle zeigt, überschreibt, das ohne Rücksicht auf den vorherigen Inhalt ofthat Handle behandelt wird, und kann Probleme für ODBC-Treiber verursachen. Es ist falsch, die ODBC-Anwendungsprogrammierung, um SQLAllocHandle zweimal mit derselben Anwendungsvariable aufzurufen, die für *OutputHandlePtr definiert ist, ohne SQLFreeHandle aufzurufen, um den Handle freizugeben, bevor es neu zugeordnet wird. Das Überschreiben von ODBC-Handles kann zu inkonsistenten Verhaltensweisen oder Fehlern im Rahmen von ODBC-Treibern führen.
SQLBrowseConnect
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | C3 [d] C4 [s] | -- [d] C2 [e] C4 [s] | (08002) | (08002) | (08002) |
SQLCloseCursor
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | -- | --[1] C5[2] |
[1] Die Verbindung war im manuellen Commitmodus.
[2] Die Verbindung war im Automatischen Commit-Modus.
SQLColumnPrivileges, SQLColumns, SQLForeignKeys, SQLGetTypeInfo, SQLPrimaryKeys, SQLProcedureColumns, SQLProcedures, SQLSpecialColumns, SQLStatistics, SQLTablePrivileges und SQLTables
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] | -- |
[1] Die Verbindung wurde im Modus für den automatischen Commit ausgeführt, oder die Datenquelle hat keine Transaktion gestartet.
[2] Die Verbindung war im manuellen Commitmodus, und die Datenquelle begann eine Transaktion.
SQLConnect
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | C4 | (08002) | (08002) | (08002) | (08002) |
SQLCopyDesc, SQLGetDescField, SQLGetDescRec, SQLSetDescField und SQLSetDescRec
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | --[1] | -- | -- |
[1] In diesem Zustand werden die einzigen für die Anwendung verfügbaren Deskriptoren explizit zugewiesen.
SQLDataSources und SQLDrivers
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | -- | -- | -- | -- | -- | -- |
SQLDisconnect
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (08003) | C2 | C2 | C2 | 25000 |
SQLDriverConnect
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | C4 s -- n[f] | (08002) | (08002) | (08002) | (08002) |
SQLEndTran
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH)[1] | --[3] | --[3] | --[3] | -- | -- | --[4] oder ([5], [6] und [8]) C4[5] und [7] C5[5], [6] und [9] |
| (IH)[2] | (IH) | (08003) | (08003) | -- | -- | C5 |
[1] Diese Zeile zeigt Übergänge an, als HandleType SQL_HANDLE_ENV wurde.
[2] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_DBC wurde.
[3] Da sich die Verbindung nicht in einem verbundenen Zustand befindet, ist sie von der Transaktion nicht betroffen.
[4] Fehler beim Commit oder Rollback für die Verbindung. Die Funktion gibt in diesem Fall SQL_ERROR zurück.
[5] Der Commit oder Rollback war für die Verbindung erfolgreich. Die Funktion gibt SQL_ERROR zurück, wenn der Commit oder Rollback bei einer anderen Verbindung fehlgeschlagen ist, oder die Funktion gibt SQL_SUCCESS zurück, wenn der Commit oder Rollback für alle Verbindungen erfolgreich war.
[6] Für die Verbindung wurde mindestens eine Anweisung zugewiesen.
[7] Es wurden keine Anweisungen für die Verbindung zugeordnet.
[8] Die Verbindung hatte mindestens eine Anweisung, für die ein geöffneter Cursor vorhanden war, und die Datenquelle behält Cursor bei, wenn Transaktionen zugesichert oder zurückgesetzt werden, je nachdem, ob CompletionType SQL_COMMIT oder SQL_ROLLBACK wurde). Weitere Informationen finden Sie unter den Attributen SQL_CURSOR_COMMIT_BEHAVIOR und SQL_CURSOR_ROLLBACK_BEHAVIOR in SQLGetInfo.
[9] Wenn die Verbindung Anweisungen hatte, für die geöffnete Cursor vorhanden waren, wurden die Cursor nicht beibehalten, wenn die Transaktion zugesichert oder zurückgesetzt wurde.
SQLExecDirect und SQLExecute
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] C6[3] | -- |
[1] Die Verbindung befand sich im Modus für den automatischen Commit, und die ausgeführte Anweisung war keine Cursorspezifikation (z. B. eine SELECT-Anweisung), oder die Verbindung befand sich im Modus für manuelles Commit, und die ausgeführte Anweisung hat keine Transaktion gestartet.
[2] Die Verbindung befand sich im Modus für den automatischen Commit, und die ausgeführte Anweisung war eine Cursorspezifikation (z. B. eine SELECT-Anweisung).
[3] Die Verbindung war im manuellen Commitmodus, und die Datenquelle begann eine Transaktion.
SQLFreeHandle
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH)[1] | C0 | (HY010) | (HY010) | (HY010) | (HY010) | (HY010) |
| (IH)[2] | (IH) | (C1) | (HY010) | (HY010) | (HY010) | (HY010) |
| (IH)[3] | (IH) | (IH) | (IH) | (IH) | C4[5] --[6] | --[7] C4[5] und [8] C5[6] und [8] |
| (IH)[4] | (IH) | (IH) | (IH) | -- | -- | -- |
[1] Diese Zeile zeigt Übergänge an, als HandleType SQL_HANDLE_ENV wurde.
[2] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_DBC wurde.
[3] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_STMT wurde.
[4] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_DESC wurde.
[5] Für die Verbindung wurde nur eine Anweisung zugewiesen.
[6] Es wurden mehrere Anweisungen für die Verbindung zugewiesen.
[7] Die Verbindung war im manuellen Commitmodus.
[8] Die Verbindung war im Automatischen Commit-Modus.
'SQLFreeStmt'
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH)[1] | (IH) | (IH) | (IH) | (IH) | -- | C5[3] --[4] |
| (IH)[2] | (IH) | (IH) | (IH) | (IH) | -- | -- |
[1] Diese Zeile zeigt Transaktionen an, wenn das Argument Option SQL_CLOSE ist.
[2] Diese Zeile zeigt Transaktionen an, wenn das Argument Option SQL_UNBIND oder SQL_RESET_PARAMS ist.
[3] Die Verbindung befand sich im Modus für den automatischen Commit, und es wurden keine Cursor für alle Anweisungen außer diesem geöffnet.
[4] Die Verbindung war im manuellen Commit-Modus oder im Auto-Commit-Modus, und ein Cursor wurde auf mindestens einer anderen Anweisung geöffnet.
SQLGetConnectAttr
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | HY010 | -- | -- | -- |
[1] Das Attributargument wurde SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE oder SQL_ATTR_TRACEFILE oder ein Wert für das Verbindungsattribute festgelegt.
[2] Das Attributargument war nicht SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE oder SQL_ATTR_TRACEFILE, und für das Verbindungsattribute wurde kein Wert festgelegt.
SQLGetDiagField und SQLGetDiagRec
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH)[1] | -- | -- | -- | -- | -- | -- |
| (IH)[2] | (IH) | -- | -- | -- | -- | -- |
| (IH)[3] | (IH) | (IH) | (IH) | (IH) | -- | -- |
| (IH)[4] | (IH) | (IH) | (IH) | -- | -- | -- |
[1] Diese Zeile zeigt Übergänge an, als HandleType SQL_HANDLE_ENV wurde.
[2] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_DBC wurde.
[3] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_STMT wurde.
[4] Diese Zeile zeigt Übergänge an, wenn HandleType SQL_HANDLE_DESC wurde.
SQLGetEnvAttr
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| IH | -- | -- | -- | -- | -- | -- |
SQLGetFunctions
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| IH | IH | HY010 | HY010 | -- | -- | -- |
SQLGetInfo
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | 08003 | -- | -- | -- |
[1] Das InfoType-Argument wurde SQL_ODBC_VER.
[2] Das InfoType-Argument wurde nicht SQL_ODBC_VER.
SQLMoreResults
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] | --[3] C5[1] |
[1] Die Verbindung befand sich im Modus für den automatischen Commit, und der Aufruf von SQLMoreResults hat die Verarbeitung eines Resultsets einer Cursorspezifikation nicht initialisiert.
[2] Die Verbindung befand sich im Modus für den automatischen Commit, und der Aufruf von SQLMoreResults hat die Verarbeitung eines Resultsets einer Cursorspezifikation initialisiert.
[3] Die Verbindung war im manuellen Commitmodus.
SQLNativeSql
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (08003) | (08003) | -- | -- | -- |
SQLPrepare
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] | -- |
[1] Die Verbindung wurde im Modus für den automatischen Commit ausgeführt, oder die Datenquelle hat keine Transaktion gestartet.
[2] Die Verbindung war im manuellen Commitmodus, und die Datenquelle begann eine Transaktion.
SQLSetConnectAttr
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | HY010 | --[3] 08002[4] HY011[5] | --[3] 08002[4] HY011[5] | --[3] und [6] C5[8] 08002[4] HY011[5] oder [7] |
[1] Das Attributargument wurde nicht SQL_ATTR_TRANSLATE_LIB oder SQL_ATTR_TRANSLATE_OPTION.
[2] Das Attributargument wurde SQL_ATTR_TRANSLATE_LIB oder SQL_ATTR_TRANSLATE_OPTION.
[3] Das Attributargument wurde nicht SQL_ATTR_ODBC_CURSORS oder SQL_ATTR_PACKET_SIZE.
[4] Das Attributargument wurde SQL_ATTR_ODBC_CURSORS.
[5] Das Attributargument wurde SQL_ATTR_PACKET_SIZE.
[6] Das Attributargument wurde nicht SQL_ATTR_AUTOCOMMIT, oder das Attributargument wurde SQL_ATTR_AUTOCOMMIT und das Festlegen dieses Attributs hat keine Commit für die Transaktion ausgeführt.
[7] Das Attributargument wurde SQL_ATTR_TXN_ISOLATION.
[8] Das Attributargument wurde SQL_ATTR_AUTOCOMMIT, und das Festlegen dieses Attributs hat die Transaktion zugesichert.
SQLSetEnvAttr
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | -- | -- | (HY010) | -- | -- | -- |
Alle anderen ODBC-Funktionen
| C0 Kein Env. |
C1 Nicht zugeordnet |
C2 Zugeordnet |
C3 Daten benötigen |
C4 Verbunden |
C5 Anweisung |
C6 Transaktion |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | -- | -- |