ODBC: Chamando funções de API ODBC diretamente

As classes de banco de dados fornecem uma interface mais simples para uma fonte de dados do que o ODBC. Como resultado, as classes não encapsulam toda a API ODBC. Para qualquer funcionalidade que esteja fora das habilidades das classes, você deve chamar funções de API ODBC diretamente. Por exemplo, você deve chamar as funções de catálogo ODBC (::SQLColumns, ::SQLProcedures, ::SQLTablese outras) diretamente.

Para chamar uma função de API ODBC diretamente, você deve seguir as mesmas etapas que tomaria se estivesse fazendo as chamadas sem a estrutura. As etapas são:

• Aloque armazenamento para quaisquer resultados que a chamada retorne.

• Passe um manipulador ODBC HDBC ou HSTMT, dependendo da assinatura do parâmetro da função. Utilize a macro AFXGetHENV para recuperar o identificador ODBC.

  Variáveis CDatabase::m_hdbc de membro e CRecordset::m_hstmt estão disponíveis para que você não precise alocá-las e inicializá-las por conta própria.

• Talvez chame funções ODBC adicionais para preparar ou acompanhar a chamada principal.

• Desaloque o armazenamento quando terminar.

Para obter mais informações sobre essas etapas, consulte a referência do programador ODBC.

Além dessas etapas, você precisa executar etapas extras para verificar os valores de retorno de função, garantir que seu programa não esteja esperando que uma chamada assíncrona seja concluída e assim por diante. Você pode simplificar essas últimas etapas usando as macros AFX_SQL_ASYNC e AFX_SQL_SYNC. Para obter mais informações, consulte Macros e globais do framework MFC.

Ver também

Noções básicas de ODBC