Função SQLSetConnectInfo

Conformidade
Versão Introduzida: ODBC 3.81 Conformidade com os Padronizados: ODBC

Summary
SQLSetConnectInfo é usado para definir a fonte de dados, ID de usuário e senha no token de informação 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] Nome 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 uma rede. Para informações sobre como um aplicativo escolhe uma fonte de dados, veja Escolha de uma Fonte de Dados ou Driver.

NameLength1
[Entrada] Comprimento de *Nome do Servidor em caracteres.

UserName
[Entrada] Identificador de usuário.

NameLength2
[Entrada] Comprimento do *Nome de Usuário em caracteres.

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

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

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

O mesmo vale para o SQLConnect para erros de validação de entrada, exceto que o Gerenciador de Drivers usa um HandleType de SQL_HANDLE_DBC_INFO_TOKEN e um Handle do hDbcInfoToken.

Remarks

Sempre que um driver retorna SQL_ERROR ou SQL_INVALID_HANDLE, o Gerenciador de Drivers retorna o erro para a aplicação (em SQLConnect ou SQLDriverConnect).

Sempre que um driver retorna SQL_SUCCESS_WITH_INFO, o Gerenciador de Drivers obterá as informações de diagnóstico do hDbcInfoToken e retornará SQL_SUCCESS_WITH_INFO para a aplicação no SQLConnect e SQLDriverConnect.

As aplicações não devem chamar essa função diretamente. Um driver ODBC que suporte pooling de conexões consciente do driver deve implementar essa função.

Incluir sqlspi.h para desenvolvimento de drivers ODBC.

Conteúdo relacionado

  • Last updated on