Função SQLGetPoolID

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

Summary
O SQLGetPoolID recupera o ID do pool.

Syntax

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Arguments

hDbcInfoToken
[Entrada] Handle de token que contém toda a informação de ligação.

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

Devoluções

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ou SQL_INVALID_HANDLE.

Diagnósticos

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

Observações

SQLGetPoolID é usado para obter o ID do pool dado um conjunto de informação de ligação (de SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo e SQLSetConnectInfo). Este ID de pool é usado para identificar um conjunto de ligações que podem ser usadas de forma intercambiável (possivelmente exigindo um reinício adicional). O ID do pool será usado para identificar o pool de ligações desse grupo de ligaçõ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