Função SQLDriverConnect

Conformidade
Versão introduzida: ODBC 1.0 Standards Compliance: ODBC

Resumo
SQLDriverConnect é uma alternativa ao SQLConnect. Ele dá suporte a fontes de dados que exigem mais informações de conexão do que os três argumentos no SQLConnect, caixas de diálogo para solicitar ao usuário todas as informações de conexão e fontes de dados que não são definidas nas informações do sistema. Para obter mais informações, consulte Conectando-se com SQLDriverConnect.

Sintaxe

  
SQLRETURN SQLDriverConnect(  
     SQLHDBC         ConnectionHandle,  
     SQLHWND         WindowHandle,  
     SQLCHAR *       InConnectionString,  
     SQLSMALLINT     StringLength1,  
     SQLCHAR *       OutConnectionString,  
     SQLSMALLINT     BufferLength,  
     SQLSMALLINT *   StringLength2Ptr,  
     SQLUSMALLINT    DriverCompletion);  

Argumentos

ConnectionHandle
[Entrada] Identificador de conexão.

Windowhandle
[Entrada] Identificador de janela. O aplicativo poderá passar o identificador da janela pai, se aplicável, ou um ponteiro nulo se o identificador de janela não for aplicável ou o SQLDriverConnect não apresentará nenhuma caixa de diálogo.

InConnectionString
[Entrada] Uma cadeia de conexão completa (consulte a sintaxe em "Comentários"), uma cadeia de conexão parcial ou uma cadeia de caracteres vazia.

StringLength1
[Entrada] Comprimento de *InConnectionString, em caracteres se a cadeia de caracteres for Unicode ou bytes se a cadeia de caracteres for ANSI ou DBCS.

OutConnectionString
[Saída] Ponteiro para um buffer para a cadeia de conexão concluída. Após a conexão bem-sucedida com a fonte de dados de destino, esse buffer contém a cadeia de conexão concluída. Os aplicativos devem alocar pelo menos 1.024 caracteres para esse buffer.

Se OutConnectionString for NULL, StringLength2Ptr ainda retornará o número total de caracteres (excluindo o caractere de terminação nula para dados de caractere) disponíveis para retornar no buffer apontado por OutConnectionString.

BufferLength
[Entrada] Comprimento do buffer *OutConnectionString , em caracteres.

StringLength2Ptr
[Saída] Ponteiro para um buffer no qual retornar o número total de caracteres (excluindo o caractere de terminação nula) disponível para retornar em *OutConnectionString. Se o número de caracteres disponíveis para retornar for maior ou igual a BufferLength, a cadeia de conexão concluída em *OutConnectionString será truncada para BufferLength menos o comprimento de um caractere de terminação nula.

DriverCompletion
[Entrada] Sinalizador que indica se o Driver Manager ou o driver devem solicitar mais informações de conexão:

SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE, SQL_DRIVER_COMPLETE_REQUIRED ou SQL_DRIVER_NOPROMPT.

(Para obter informações adicionais, consulte "Comentários".

Retornos

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_NO_DATA, SQL_ERROR, SQL_INVALID_HANDLE ou SQL_STILL_EXECUTING.

Diagnósticos

Quando SQLDriverConnect retorna SQL_ERROR ou SQL_SUCCESS_WITH_INFO, um valor SQLSTATE associado pode ser obtido chamando SQLGetDiagRec com um fHandleType de SQL_HANDLE_DBC e um hHandle de ConnectionHandle. A tabela a seguir lista os valores SQLSTATE normalmente retornados por SQLDriverConnect e explica cada um deles no contexto dessa função; a notação "(DM)" precede as descrições de SQLSTATEs retornadas pelo Gerenciador de Driver. O código de retorno associado a cada valor SQLSTATE é SQL_ERROR, a menos que indicado de outra forma.

Comentários

Uma cadeia de conexão tem a seguinte sintaxe:

connection-string ::= empty-string[;] | attribute[;] | atributo; cadeia de conexão

empty-string ::=attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]

attribute-keyword ::= DSN | UID | PWD | driver-defined-attribute-keyword

attribute-value ::= character-string

driver-defined-attribute-keyword ::= identifier

em que character-string tem zero ou mais caracteres; O identificador tem um ou mais caracteres; attribute-keyword não diferencia maiúsculas de minúsculas; attribute-value pode diferenciar maiúsculas de minúsculas; e o valor da palavra-chave DSN não consiste apenas em espaços em branco.

Devido à cadeia de conexão e à gramática do arquivo de inicialização, palavras-chave e valores de atributo que contêm os caracteres []{}();? *=!@ não entre chaves deve ser evitado. O valor da palavra-chave DSN não pode consistir apenas em espaços em branco e não deve conter espaços em branco à esquerda. Devido à gramática das informações do sistema, palavras-chave e nomes de fonte de dados não podem conter o caractere de barra invertida (\).

Os aplicativos não precisam adicionar chaves ao redor do valor do atributo após a palavra-chave DRIVER , a menos que o atributo contenha um ponto e vírgula (;), nesse caso, as chaves são necessárias. Se o valor do atributo que o driver recebe incluir chaves, o driver não deve removê-los, mas deve fazer parte da cadeia de conexão retornada.

Um valor de cadeia de conexão ou DSN entre chaves ({}) que contém qualquer um dos caracteres []{}();? *=!@ é passado intacto para o driver. No entanto, ao usar esses caracteres em uma palavra-chave, o Gerenciador de Driver retorna um erro ao trabalhar com DSNs de arquivo, mas passa a cadeia de conexão para o driver para cadeias de conexão regulares. Evite usar chaves inseridas em um valor de palavra-chave.

A cadeia de conexão pode incluir qualquer número de palavras-chave definidas pelo driver. Como a palavra-chave DRIVER não usa informações das informações do sistema, o driver deve definir palavras-chave suficientes para que um driver possa se conectar a uma fonte de dados usando apenas as informações na cadeia de conexão. (Para obter mais informações, confira "Diretrizes de driver", mais adiante nesta seção.) O driver define quais palavras-chave são necessárias para se conectar à fonte de dados.

A tabela a seguir descreve os valores de atributo das palavras-chave DSN, FILEDSN, DRIVER, UID, PWD e SAVEFILE .

Para obter informações sobre como um aplicativo escolhe uma fonte de dados ou driver, consulte Escolhendo uma fonte de dados ou driver.

Se alguma palavra-chave for repetida na cadeia de conexão, o driver usará o valor associado à primeira ocorrência da palavra-chave. Se as palavras-chave DSN e DRIVER forem incluídas na mesma cadeia de conexão, o Gerenciador de Driver e o driver usarão qualquer palavra-chave exibida primeiro.

As palavras-chave FILEDSN e DSN são mutuamente exclusivas: qualquer palavra-chave exibida primeiro é usada e a que aparece em segundo é ignorada. As palavras-chave FILEDSN e DRIVER , por outro lado, não são mutuamente exclusivas. Se qualquer palavra-chave aparecer em uma cadeia de conexão com FILESN, o valor do atributo da palavra-chave na cadeia de conexão será usado em vez do valor do atributo da mesma palavra-chave no arquivo .dsn.

Se a palavra-chave FILESN for usada, as palavras-chave especificadas em um arquivo .dsn serão usadas para criar uma cadeia de conexão. (Para obter mais informações, confira "Fontes de dados de arquivo", mais adiante nesta seção.) A palavra-chave UID é opcional; um arquivo .dsn pode ser criado apenas com a palavra-chave DRIVER . A palavra-chave PWD não é armazenada em um arquivo .dsn. O diretório padrão para salvar e carregar um arquivo .dsn será uma combinação do caminho especificado por CommonFileDir em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ Windows\CurrentVersion e "ODBC\DataSources". (Se CommonFileDir fosse "C:\Arquivos de Programas\Arquivos Comuns", o diretório padrão seria "C:\Arquivos de Programas\Arquivos Comuns\ODBC\Fontes de Dados".)

Se a palavra-chave SAVEFILE for usada, os valores de atributo das palavras-chave usadas na criação da conexão atual e bem-sucedida serão salvos como um arquivo .dsn com o nome do valor do atributo da palavra-chave SAVEFILE . A palavra-chave SAVEFILE deve ser usada em conjunto com a palavra-chave DRIVER , a palavra-chave FILEDSN ou ambas, ou a função retorna SQL_SUCCESS_WITH_INFO com SQLSTATE 01S09 (palavra-chave inválida). A palavra-chave SAVEFILE deve aparecer antes da palavra-chave DRIVER na cadeia de conexão ou os resultados serão indefinidos.

Diretrizes do Gerenciador de Driver

O Gerenciador de Driver constrói uma cadeia de conexão para passar para o driver no argumento InConnectionString da função SQLDriverConnect do driver. O Gerenciador de Driver não modifica o argumento InConnectionString passado para ele pelo aplicativo.

A ação do Gerenciador de Driver baseia-se no valor do argumento DriverCompletion :

• SQL_DRIVER_PROMPT: se a cadeia de conexão não contiver a palavra-chave DRIVER, DSN ou FILESN , o Gerenciador de Driver exibirá a caixa de diálogo Fontes de Dados. Ele constrói uma cadeia de conexão com base no nome da fonte de dados retornado pela caixa de diálogo e quaisquer outras palavras-chave passadas para ela pelo aplicativo. Se o nome da fonte de dados retornado pela caixa de diálogo estiver vazio, o Gerenciador de Driver especificará o par chave-valor DSN=Default. (Essa caixa de diálogo não exibirá uma fonte de dados com o nome "Padrão".)

• SQL_DRIVER_COMPLETE ou SQL_DRIVER_COMPLETE_REQUIRED: se a cadeia de conexão especificada pelo aplicativo incluir a palavra-chave DSN , o Gerenciador de Driver copiará a cadeia de conexão especificada pelo aplicativo. Caso contrário, ele executa as mesmas ações que quando DriverCompletion é SQL_DRIVER_PROMPT.

• SQL_DRIVER_NOPROMPT: o Gerenciador de Driver copia a cadeia de conexão especificada pelo aplicativo.

Se a cadeia de conexão especificada pelo aplicativo contiver a palavra-chave DRIVER , o Gerenciador de Driver copiará a cadeia de conexão especificada pelo aplicativo.

Usando a cadeia de conexão construída, o Gerenciador de Driver determina qual driver usar, conecta-se a esse driver e passa a cadeia de conexão que construiu para o driver; para obter mais informações sobre a interação do Gerenciador de Driver e do driver, consulte a seção "Comentários" na Função SQLConnect. Se a cadeia de conexão não contiver a palavra-chave DRIVER , o Gerenciador de Driver determinará qual driver usar da seguinte maneira:

1. Se a cadeia de conexão contiver a palavra-chave DSN , o Gerenciador de Driver recuperará o driver associado à fonte de dados das informações do sistema.

2. Se a cadeia de conexão não contiver a palavra-chave DSN ou a fonte de dados não for encontrada, o Gerenciador de Driver recuperará o driver associado à fonte de dados Padrão das informações do sistema. (Para obter mais informações, consulte Subchave Padrão.) O Gerenciador de Driver altera o valor da palavra-chave DSN na cadeia de conexão para "DEFAULT".

3. Se a palavra-chave DSN na cadeia de conexão estiver definida como "DEFAULT", o Gerenciador de Driver recuperará o driver associado à fonte de dados Padrão das informações do sistema.

4. Se a fonte de dados não for encontrada e a fonte de dados Padrão não for encontrada, o Gerenciador de Driver retornará SQL_ERROR com SQLSTATE IM002 (fonte de dados não encontrada e nenhum driver padrão especificado).

Fontes de dados do arquivo

Se a cadeia de conexão especificada pelo aplicativo na chamada para SQLDriverConnect contiver a palavra-chave FILESN e essa palavra-chave não for substituída pela palavra-chave DSN ou DRIVER , o Gerenciador de Driver criará uma cadeia de conexão usando as informações no arquivo .dsn e o argumento InConnectionString . O Gerenciador de Driver continua da seguinte maneira:

1. Verifica se o nome do arquivo .dsn é válido. Caso contrário, ele retornará SQL_ERROR com SQLSTATE IM014 (nome inválido do DSN do arquivo). Se o nome do arquivo for uma cadeia de caracteres vazia ("") e SQL_DRIVER_NOPROMPT não for especificado, a caixa de diálogo Abrir Arquivo será exibida. Se o nome do arquivo contiver um caminho válido, mas nenhum nome de arquivo ou um nome de arquivo inválido e SQL_DRIVER_NOPROMPT não for especificado, a caixa de diálogo Abrir Arquivo será exibida com o diretório atual definido como aquele especificado no nome do arquivo. Se o nome do arquivo for uma cadeia de caracteres vazia ("") ou o nome do arquivo contiver um caminho válido, mas nenhum nome de arquivo ou um nome de arquivo inválido e SQL_DRIVER_NOPROMPT for especificado, SQL_ERROR será retornado com SQLSTATE IM014 (nome inválido do arquivo DSN).

2. Lê todas as palavras-chave na seção [ODBC] do arquivo .dsn. Se a palavra-chave DRIVER não estiver presente, ela retornará SQL_ERROR com SQLSTATE IM012 (erro de sintaxe da palavra-chave driver), exceto quando o arquivo .dsn for incompartível e, portanto, conterá apenas a palavra-chave DSN .

   Se a fonte de dados do arquivo for incompartilhada, o Gerenciador de Driver lerá o valor da palavra-chave DSN e se conectará conforme necessário à fonte de dados do usuário ou do sistema apontada pela fonte de dados de arquivo não compartilhada. As etapas 3 a 5 não são executadas.

3. Constrói uma cadeia de conexão para o driver. A cadeia de conexão do driver é a união das palavras-chave especificadas no arquivo .dsn e as especificadas na cadeia de conexão do aplicativo original. As regras para a construção da cadeia de conexão do driver em que as palavras-chave se sobrepõem são as seguintes:

   • Se a palavra-chave DRIVER existir na cadeia de conexão do aplicativo e os drivers especificados pelas palavras-chave DRIVER não forem os mesmos no arquivo .dsn e na cadeia de conexão do aplicativo, as informações do driver no arquivo .dsn serão ignoradas e as informações do driver na cadeia de conexão do aplicativo serão usadas. Se os drivers especificados pela palavra-chave DRIVER forem os mesmos no arquivo .dsn e na cadeia de conexão do aplicativo, em que todas as palavras-chave se sobrepõem, as especificadas na cadeia de conexão do aplicativo terão precedência sobre as especificadas no arquivo .dsn.

   • Na nova cadeia de conexão, a palavra-chave FILEDSN é eliminada.

4. Carrega o driver examinando a entrada do Registro HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\<Nome> do Driver\Driver em <que o Nome> do Driver é especificado pela palavra-chave DRIVER .

5. Passa ao driver a nova cadeia de conexões.

Para obter exemplos de arquivos .dsn, consulte Conectando-se usando fontes de dados de arquivo.

Palavra-chave SAVEFILE

Se a cadeia de conexão especificada pelo aplicativo contiver a palavra-chave SAVEFILE , o Gerenciador de Driver salvará a cadeia de conexão em um arquivo .dsn. O Gerenciador de Driver continua da seguinte maneira:

1. Verifica se o nome do arquivo .dsn incluído como o valor do atributo da palavra-chave SAVEFILE é válido. Caso contrário, ele retornará SQL_ERROR com SQLSTATE IM014 (nome inválido do DSN do arquivo). A validade do nome do arquivo é determinada pelas regras de nomenclatura padrão do sistema. Se o nome do arquivo for uma cadeia de caracteres vazia ("") e o argumento DriverCompletion não for SQL_DRIVER_NOPROMPT, o nome do arquivo será válido. Se o nome do arquivo já existir, se DriverCompletion for SQL_DRIVER_NOPROMPT, o arquivo será substituído. Se DriverCompletion for SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE ou SQL_DRIVER_COMPLETE_REQUIRED, uma caixa de diálogo solicitará que o usuário especifique se o arquivo deve ser substituído. Se Não for inserido, a caixa de diálogo Salvar Arquivo será exibida.

2. Se o driver retornar SQL_SUCCESS e o nome do arquivo não for uma cadeia de caracteres vazia, o Gerenciador de Driver gravará as informações de conexão retornadas no argumento OutConnectionString no arquivo especificado com o formato especificado na seção "Cadeias de Conexão" anteriormente nesta seção.

3. Se o driver retornar SQL_SUCCESS e o nome do arquivo for uma cadeia de caracteres vazia (""), o Gerenciador de Driver chamará a caixa de diálogo comum File-Save com o hwnd especificado e gravará as informações de conexão retornadas em OutConnectionString no arquivo especificado na caixa de diálogo comum File-Save com o formato especificado na seção "Cadeias de Conexão" anteriormente nesta seção.

4. Se o driver retornar SQL_SUCCESS, ele retornará o argumento OutConnectionString que contém a cadeia de conexão para o aplicativo.

5. Se o driver retornar SQL_SUCCESS_WITH_INFO ou SQL_ERROR, o Gerenciador de Driver retornará o SQLSTATE para o aplicativo.

Diretrizes de driver

O driver verifica se a cadeia de conexão passada para ela pelo Gerenciador de Driver contém a palavra-chave DSN ou DRIVER . Se a cadeia de conexão contiver a palavra-chave DRIVER , o driver não poderá recuperar informações sobre a fonte de dados das informações do sistema. Se a cadeia de conexão contiver a palavra-chave DSN ou não contiver a palavra-chave DSN ou DRIVER , o driver poderá recuperar informações sobre a fonte de dados das informações do sistema da seguinte maneira:

1. Se a cadeia de conexão contiver a palavra-chave DSN , o driver recuperará as informações da fonte de dados especificada.

2. Se a cadeia de conexão não contiver a palavra-chave DSN , a fonte de dados especificada não for encontrada ou a palavra-chave DSN for definida como "DEFAULT", o driver recuperará as informações para a fonte de dados Padrão.

O driver usa todas as informações que recupera das informações do sistema para aumentar as informações passadas para ele na cadeia de conexão. Se as informações nas informações do sistema duplicarem as informações na cadeia de conexão, o driver usará as informações na cadeia de conexão.

Com base no valor de DriverCompletion, o driver solicita ao usuário informações de conexão, como a ID de usuário e a senha, e se conecta à fonte de dados:

• SQL_DRIVER_PROMPT: o driver exibe uma caixa de diálogo, usando os valores da cadeia de conexão e informações do sistema (se houver) como valores iniciais. Quando o usuário sai da caixa de diálogo, o driver se conecta à fonte de dados. Ele também constrói uma cadeia de conexão com base no valor da palavra-chave DSN ou DRIVER em *InConnectionString e as informações retornadas da caixa de diálogo. Ele coloca essa cadeia de conexão no buffer *OutConnectionString .

• SQL_DRIVER_COMPLETE ou SQL_DRIVER_COMPLETE_REQUIRED: se a cadeia de conexão contiver informações suficientes e essas informações estiverem corretas, o driver se conectará à fonte de dados e copiará *InConnectionString para *OutConnectionString. Se alguma informação estiver ausente ou incorreta, o driver executará as mesmas ações que quando DriverCompletion estiver SQL_DRIVER_PROMPT, exceto que, se DriverCompletion for SQL_DRIVER_COMPLETE_REQUIRED, o driver desabilitará os controles para obter informações não necessárias para se conectar à fonte de dados.

• SQL_DRIVER_NOPROMPT: se a cadeia de conexão contiver informações suficientes, o driver se conectará à fonte de dados e copiará *InConnectionString para *OutConnectionString. Caso contrário, o driver retornará SQL_ERROR para SQLDriverConnect.

Na conexão bem-sucedida com a fonte de dados, o driver também define *StringLength2Ptr para o comprimento da cadeia de conexão de saída que está disponível para retornar em *OutConnectionString.

Se o usuário cancelar uma caixa de diálogo apresentada pelo Gerenciador de Driver ou pelo driver, SQLDriverConnect retornará SQL_NO_DATA.

Para obter informações sobre como o Gerenciador de Driver e o driver interagem durante o processo de conexão, consulte Função SQLConnect.

Se um driver der suporte a SQLDriverConnect, a seção de palavra-chave do driver das informações do sistema para o driver deverá conter a palavra-chave ConnectFunctions com o segundo caractere definido como "Y".

Conectando quando o pool de conexões está habilitado

O pool de conexões permite que um aplicativo reutilize uma conexão que já foi criada. Quando SQLDriverConnect é chamado, o Gerenciador de Driver tenta fazer a conexão usando uma conexão que faz parte de um pool de conexões em um ambiente designado para pool de conexões. Para obter mais informações sobre o pool de conexões, consulte Função SQLConnect.

Um aplicativo pode definir SQL_ATTR_RESET_CONNECTION antes de chamar SQLDisconnect em uma conexão em que o pooling está habilitado. Para obter mais informações, consulte Função SQLSetConnectAttr.

As seguintes restrições se aplicam quando um aplicativo chama SQLDriverConnect para se conectar a uma conexão em pool:

• Nenhum processamento de pool de conexões é executado quando a palavra-chave SAVEFILE é especificada na cadeia de conexão.

• Se o pool de conexões estiver habilitado, SQLDriverConnect só poderá ser chamado com um argumento DriverCompletion de SQL_DRIVER_NOPROMPT; se SQLDriverConnect for chamado com qualquer outro DriverCompletion, SQLSTATE HY110 (conclusão inválida do driver) será retornado.

Atributos de conexão

O atributo de conexão SQL_ATTR_LOGIN_TIMEOUT, definido usando SQLSetConnectAttr, define o número de segundos para aguardar a conclusão de uma solicitação de logon com uma conexão bem-sucedida pelo driver antes de retornar ao aplicativo. Se o usuário for solicitado a concluir a cadeia de conexão, um período de espera para cada solicitação de logon começará quando o driver iniciar o processo de conexão.

O driver abre a conexão no modo de acesso SQL_MODE_READ_WRITE por padrão. Para definir o modo de acesso como SQL_MODE_READ_ONLY, o aplicativo deve chamar SQLSetConnectAttr com o atributo SQL_ATTR_ACCESS_MODE antes de chamar SQLDriverConnect.

Se uma biblioteca de tradução padrão for especificada nas informações do sistema para a fonte de dados, o driver a carregará. Uma biblioteca de tradução diferente pode ser carregada chamando SQLSetConnectAttr com o atributo SQL_ATTR_TRANSLATE_LIB. Uma opção de tradução pode ser especificada chamando SQLSetConnectAttr com a opção SQL_ATTR_TRANSLATE_OPTION.

Para obter mais informações, consulte Conectando-se com SQLDriverConnect.

// SQLDriverConnect_ref.cpp  
// compile with: odbc32.lib user32.lib  
#include <windows.h>  
#include <sqlext.h>  
  
int main() {  
   SQLHENV henv;  
   SQLHDBC hdbc;  
   SQLHSTMT hstmt;  
   SQLRETURN retcode;  
  
   SQLCHAR OutConnStr[255];  
   SQLSMALLINT OutConnStrLen;  
  
   HWND desktopHandle = GetDesktopWindow();   // desktop's window handle  
  
   // Allocate environment handle  
   retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);  
  
   // Set the ODBC version environment attribute  
   if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
      retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER*)SQL_OV_ODBC3, 0);   
  
      // Allocate connection handle  
      if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
         retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);   
  
         // Set login timeout to 5 seconds  
         if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
            SQLSetConnectAttr(hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER)5, 0);  
  
            retcode = SQLDriverConnect( // SQL_NULL_HDBC  
               hdbc,   
               desktopHandle,   
               (SQLCHAR*)"driver=SQL Server",   
               _countof("driver=SQL Server"),  
               OutConnStr,  
               255,   
               &OutConnStrLen,  
               SQL_DRIVER_PROMPT );  
  
            // Allocate statement handle  
            if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {                 
               retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);   
  
               // Process data  
               if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
                  SQLFreeHandle(SQL_HANDLE_STMT, hstmt);  
               }  
  
               SQLDisconnect(hdbc);  
            }  
  
            SQLFreeHandle(SQL_HANDLE_DBC, hdbc);  
         }  
      }  
      SQLFreeHandle(SQL_HANDLE_ENV, henv);  
   }  
}  

Confira também Exemplo de Programa ODBC.

Funções relacionadas

Consulte Também

Referência de API do ODBC
Arquivos de cabeçalho ODBC