Função SQLSetConnectInfo

Conformidade
Versão Introduzida: Conformidade com as Normas ODBC 3.81: ODBC

Summary
O SQLSetConnectInfo é usado para definir a fonte de dados, o ID do utilizador e a palavra-passe no token de informação de ligação para a chamada SQLConnect de uma aplicação.

Syntax

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

Arguments

TokenHandle
[Entrada] Nome de identificação do token.

ServerName
[Entrada] Nome da fonte de dados. Os dados podem estar localizados no mesmo computador que o programa, ou noutro computador algures numa rede. Para informações sobre como uma aplicação escolhe uma fonte de dados, consulte Escolher uma Fonte de Dados ou Driver.

NomeComprimento1
[Entrada] Comprimento de *NomeServidor em caracteres.

UserName
[Entrada] Identificador de utilizador.

NomeComprimento2
[Entrada] Comprimento do *Nome de Utilizador em caracteres.

Authentication
[Entrada] String de autenticação (normalmente a palavra-passe).

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

Devoluções

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnósticos

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

Observações

Sempre que um driver devolve SQL_ERROR ou SQL_INVALID_HANDLE, o Gestor de Drivers devolve o erro à aplicação (em SQLConnect ou SQLDriverConnect).

Sempre que um driver retorna SQL_SUCCESS_WITH_INFO, o Gestor de Drivers obtém a informação de diagnóstico do hDbcInfoToken e devolve SQL_SUCCESS_WITH_INFO à aplicação no SQLConnect e SQLDriverConnect.

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

Incluir sqlspi.h para desenvolvimento de drivers ODBC.

Conteúdo relacionado

  • Last updated on