Função SQLSetConnectInfo

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

Resumo
SQLSetConnectInfo é usado para definir a fonte de dados, a ID do usuário e a senha no token de informações de conexão para a chamada SQLConnect de um aplicativo.

Sintaxe

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );  

Argumentos

TokenHandle
[Entrada] Identificador de token.

ServerName
[Entrada] Nome da fonte de dados. Os dados podem estar localizados no mesmo computador que o programa ou em outro computador em algum lugar em uma rede. Para obter informações sobre como um aplicativo escolhe uma fonte de dados, consulte Escolhendo uma fonte de dados ou driver.

NameLength1
[Entrada] Comprimento de *ServerName em caracteres.

UserName
[Entrada] Identificador de usuário.

NameLength2
[Entrada] Comprimento de *UserName em caracteres.

Autenticação
[Entrada] Cadeia de caracteres de autenticação (normalmente a senha).

NameLength3
[Entrada] Comprimento de *Autenticação em caracteres.

Retornos

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnósticos

O mesmo que SQLConnect para erros 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