Recursos duplicados
As seguintes funções ODBC 2.x foram duplicadas por funções ODBC 3.x. Assim, as funções ODBC 2.x são preteridas no ODBC 3.x. As funções ODBC 3.x são chamadas de funções substitutas.
Quando um aplicativo usa uma função ODBC 2.x preterida e o driver subjacente é um driver ODBC 3.x, o Gerenciador de Driver mapeia a chamada de função para a função de substituta correspondente. A única exceção a essa regra é SQLExtendedFetch. (Confira a nota de rodapé no final da tabela a seguir.) Para obter mais informações sobre esses mapeamentos, confira Como mapear funções preteridas no Apêndice G: Diretrizes de driver para compatibilidade com versões anteriores.
Quando um aplicativo usa uma função substituta e o driver subjacente é um ODBC 2.x, o Gerenciador de Driver mapeia a chamada de função para a função preterida correspondente.
| Função ODBC 2.x | Função ODBC 3.x |
|---|---|
| SQLAllocConnect | SQLAllocHandle |
| SQLAllocEnv | SQLAllocHandle |
| SQLAllocStmt | SQLAllocHandle |
| SQLColAttributes | SQLColAttribute |
| SQLError | SQLGetDiagRec |
| SQLExtendedFetch[1] | SQLFetchScroll |
| SQLFreeConnect | SQLFreeHandle |
| SQLFreeEnv | SQLFreeHandle |
| SQLGetConnectOption | SQLGetConnectAttr |
| SQLGetStmtOption | SQLGetStmtAttr |
| SQLParamOptions | SQLSetStmtAttr, SQLGetStmtAttr |
| SQLSetConnectOption | SQLSetConnectAttr |
| SQLSetParam | SQLBindParameter |
| SQLSetStmtOption | SQLSetStmtAttr |
| SQLTransact | SQLEndTran |
[1] A função SQLExtendedFetch é funcionalidade duplicada. SQLFetchScroll fornece a mesma funcionalidade no ODBC 3.x. Porém, o Gerenciador de driver não mapeia SQLExtendedFetch para SQLFetchScroll com relação a um driver ODBC 3.x. Para obter mais informações, confira O que o Gerenciador de Driver faz no Apêndice G: Diretrizes de driver para compatibilidade com versões anteriores. O Gerenciador de Driver mapeia SQLFetchScroll para SQLExtendedFetch com relação a um driver ODBC 2.x.
Observação
A função SQLBindParam é uma situação especial. SQLBindParam é uma funcionalidade duplicada. Ela não é uma função ODBC 2.x, mas uma função presente nos padrões Open Group e ISO. A funcionalidade fornecida por essa função é completamente inclusa na do SQLBindParameter. Assim, o Gerenciador de Driver mapeia uma chamada para SQLBindParam para SQLBindParameter quando o driver subjacente é um driver ODBC 3.x. No entanto, quando o driver subjacente é um driver ODBC 2.x, o Gerenciador de driver não executa esse mapeamento.