Função SQLSetDriverConnectInfo

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

Resumo
SQLSetDriverConnectInfo é usado para definir a cadeia de conexão no token de informações de conexão para a chamada SQLDriverConnect de um aplicativo.

Sintaxe

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );  

Argumentos

TokenHandle
[Entrada] Identificador de token.

InConnectionString
[Entrada] Uma cadeia de conexão completa (consulte a sintaxe em "Comentários" em SQLDriverConnect), 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.

Retornos

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnósticos

O mesmo que SQLDriverConnect relacionado a qualquer erro de validação de entrada, exceto que o Gerenciador de Driver usará um HandleType de SQL_HANDLE_DBC_INFO_TOKEN e um Identificador de hDbcInfoToken.

Comentários

Sempre que um driver retorna SQL_ERROR ou SQL_INVALID_HANDLE, o Gerenciador de Driver retorna o erro para o aplicativo (em SQLConnect ou SQLDriverConnect).

Sempre que um driver retornar SQL_SUCCESS_WITH_INFO, o Gerenciador de Driver obterá as informações de diagnóstico de hDbcInfoToken e retornará SQL_SUCCESS_WITH_INFO ao aplicativo em SQLConnect e SQLDriverConnect.

Os aplicativos não devem chamar essa função diretamente. Um driver ODBC que dá suporte ao pool de conexões com reconhecimento de driver deve implementar essa função.

Inclua sqlspi.h para desenvolvimento de driver ODBC.

Consulte Também

Desenvolver um driver ODBC
Pool de conexões com reconhecimento de driver
Desenvolvimento um reconhecimento de pool de conexão em um driver ODBC