Função SQLSetDriverConnectInfo

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

Summary
SQLSetDriverConnectInfo é usado para definir a cadeia de conexão no token de informação de conexão para a chamada SQLDriverConnect de uma aplicação.

Sintaxe

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

Argumentos

TokenHandle
[Entrada] Nome de token.

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

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

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

O mesmo que o SQLDriverConnect se aplica a qualquer erro de validação de entrada, exceto que o Gerenciador de Drivers usará um HandleType de SQL_HANDLE_DBC_INFO_TOKEN e um Handle de 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