Função SQLGetPoolID

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

Resumo
SQLGetPoolID recupera a ID do pool.

Sintaxe

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );  

Argumentos

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

pPoolID
[Saída] A ID do pool, que é usada para identificar um conjunto de conexões que podem ser usadas de forma intercambiável (possivelmente exigindo uma redefinição adicional).

Retornos

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnósticos

Quando SQLGetPoolID retornar SQL_ERROR ou SQL_SUCCESS_WITH_INFO, o Gerenciador de Driver usará um HandleType de SQL_HANDLE_DBC_INFO_TOKEN e um Identificador de hDbcInfoToken.

Comentários

SQLGetPoolID é usado para obter a ID do pool dado um conjunto de informações de conexão (de SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo e SQLSetConnectInfo). Essa ID do pool é usada para identificar um conjunto de conexões que podem ser usadas de forma intercambiável (possivelmente exigindo uma redefinição adicional). A ID do pool será usada para identificar o pool de conexões desse grupo de conexões.

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