Função SQLGetPoolID

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

Summary
SQLGetPoolID recupera o ID do pool.

Sintaxe

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Argumentos

hDbcInfoToken
[Entrada] Handle de token que contém todas as informações de conexão.

pPoolID
[Saída] O ID do pool, que é usado para identificar um conjunto de conexões que podem ser usadas de forma intercambiável (possivelmente exigindo um reset adicional).

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnostics

Quando SQLGetPoolID retorna SQL_ERROR ou SQL_SUCCESS_WITH_INFO, o Gerenciador de Drivers usará um HandleType de SQL_HANDLE_DBC_INFO_TOKEN e um Handle de hDbcInfoToken.

Remarks

SQLGetPoolID é usado para obter o ID do pool dado um conjunto de informações de conexão (de SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo e SQLSetConnectInfo). Esse ID de pool é usado para identificar um conjunto de conexões que podem ser usadas de forma intercambiável (possivelmente exigindo um reset adicional). O ID do pool será usado para identificar o pool de conexões para aquele grupo de conexões.

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