Función SQLGetPoolID

Conformidad
Versión introducida: ODBC 3.81 Cumplimiento de estándares: ODBC

Summary
SQLGetPoolID recupera el ID del pool.

Sintaxis

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Argumentos

hDbcInfoToken
[Entrada] Handle de token que contiene toda la información de conexión.

pPoolID
[Salida] El ID del pool, que se utiliza para identificar un conjunto de conexiones que pueden usarse indistintamente (posiblemente requiriendo un reinicio adicional).

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnósticos

Cuando SQLGetPoolID devuelva SQL_ERROR o SQL_SUCCESS_WITH_INFO, el Gestor de Controladores usará un HandleType de SQL_HANDLE_DBC_INFO_TOKEN y un Handle de hDbcInfoToken.

Remarks

SQLGetPoolID se utiliza para obtener el ID del pool dado un conjunto de información de conexión (de SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo y SQLSetConnectInfo). Este ID de pool se utiliza para identificar un conjunto de conexiones que pueden usarse indistintamente (posiblemente requiriendo un reinicio adicional). El ID del pool se usará para identificar el pool de conexiones para ese grupo de conexiones.

Siempre que un controlador devuelve SQL_ERROR o SQL_INVALID_HANDLE, el Administrador de Controladores devuelve el error a la aplicación (en SQLConnect o SQLDriverConnect).

Cada vez que un controlador devuelva SQL_SUCCESS_WITH_INFO, el Administrador de Controladores obtendrá la información de diagnóstico de hDbcInfoToken y devolverá SQL_SUCCESS_WITH_INFO a la aplicación en SQLConnect y SQLDriverConnect.

Las aplicaciones no deben llamar directamente a esta función. Un controlador ODBC que soporte pooling de conexiones consciente del controlador debe implementar esta función.

Incluye sqlspi.h para el desarrollo de controladores ODBC.

Contenido relacionado

  • Last updated on