Transições de ambiente
Os ambientes ODBC têm os três estados a seguir.
| Estado | Descrição |
|---|---|
| E0 | Ambiente não alocado |
| E1 | Ambiente alocado, conexão não alocada |
| E2 | Ambiente alocado, conexão alocada |
As tabelas a seguir mostram como cada função ODBC afeta o estado do ambiente.
SQLAllocHandle
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| E1[1] | --[4] | --[4] |
| (IH) [2] | E2[5] (HY010) [6] |
--[4] |
| (IH) [3] | (IH) | --[4] |
[1] Essa linha mostra transições quando HandleType foi SQL_HANDLE_ENV.
[2] Essa linha mostra transições quando HandleType foi SQL_HANDLE_DBC.
[3] Essa linha mostra transições quando HandleType foi SQL_HANDLE_STMT ou SQL_HANDLE_DESC.
[4] Chamar SQLAllocHandle com OutputHandlePtr apontando para um identificador válido substitui esse identificador. Isso pode ser um erro de programação de aplicativo.
[5] O atributo de ambiente SQL_ATTR_ODBC_VERSION foi definido no ambiente.
[6] O atributo de ambiente SQL_ATTR_ODBC_VERSION não havia sido definido no ambiente.
SQLDataSources e SQLDrivers
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| (IH) | --[1] (HY010) [2] |
--[1] (HY010) [2] |
[1] O atributo de ambiente SQL_ATTR_ODBC_VERSION foi definido no ambiente.
[2] O atributo de ambiente SQL_ATTR_ODBC_VERSION não havia sido definido no ambiente.
SQLEndTran
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| (IH) [1] | --[3] (HY010) [4] |
--[3] (HY010) [4] |
| (IH) [2] | (IH) | -- |
[1] Essa linha mostra transições quando HandleType foi SQL_HANDLE_ENV.
[2] Essa linha mostra transições quando HandleType foi SQL_HANDLE_DBC.
[3] O atributo de ambiente SQL_ATTR_ODBC_VERSION foi definido no ambiente.
[4] O atributo de ambiente SQL_ATTR_ODBC_VERSION não havia sido definido no ambiente.
SQLFreeHandle
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| (IH) [1] | E0 | (HY010) |
| (IH) [2] | (IH) | --[4] E1[5] |
| (IH) [3] | (IH) | -- |
[1] Essa linha mostra transições quando HandleType foi SQL_HANDLE_ENV.
[2] Essa linha mostra transições quando HandleType foi SQL_HANDLE_DBC.
[3] Essa linha mostra transições quando HandleType foi SQL_HANDLE_STMT ou SQL_HANDLE_DESC.
[4] Havia outros identificadores de conexão alocados.
[5] O identificador de conexão especificado no Handle era o único identificador de conexão alocado.
SQLGetDiagField e SQLGetDiagRec
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| (IH) [1] | -- | -- |
| (IH) [2] | (IH) | -- |
[1] Essa linha mostra transições quando HandleType foi SQL_HANDLE_ENV.
[2] Essa linha mostra transições quando HandleType era SQL_HANDLE_DBC, SQL_HANDLE_STMT ou SQL_HANDLE_DESC.
SQLGetEnvAttr
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| (IH) | --[1] (HY010) [2] |
-- |
[1] O atributo de ambiente SQL_ATTR_ODBC_VERSION foi definido no ambiente.
[2] O atributo de ambiente SQL_ATTR_ODBC_VERSION não havia sido definido no ambiente.
SQLSetEnvAttr
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| (IH) | --[1] (HY010) [2] |
(HY011) |
[1] O atributo de ambiente SQL_ATTR_ODBC_VERSION foi definido no ambiente.
[2] O argumento Attribute não foi SQL_ATTR_ODBC_VERSION e o atributo de ambiente SQL_ATTR_ODBC_VERSION não havia sido definido no ambiente.
Todas as outras funções ODBC
| E0 Não alocado |
E1 Alocado |
E2 Conexão |
|---|---|---|
| (IH) | (IH) | -- |