Compartir a través de

Función SQLGetPoolID

  • Artículo

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

Resumen
SQLGetPoolID recupera el identificador del grupo.

Sintaxis

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Argumentos

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

pPoolID
[Salida] El identificador del grupo, que se usa para identificar un conjunto de conexiones que se pueden usar indistintamente (posiblemente requerir un restablecimiento adicional).

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnóstico

Cuando SQLGetPoolID devuelve SQL_ERROR o SQL_SUCCESS_WITH_INFO, el Administrador de controladores usará un handleType de SQL_HANDLE_DBC_INFO_TOKEN y un identificador de hDbcInfoToken.

Comentarios

SQLGetPoolID se usa para obtener el identificador del grupo según un conjunto de información de conexión (de SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo y SQLSetConnectInfo). Este identificador de grupo se usa para identificar un conjunto de conexiones que se pueden usar indistintamente (posiblemente requerir un restablecimiento adicional). El identificador del grupo se usará para identificar el grupo de conexiones para ese grupo de conexiones.

Cada vez 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 devuelve 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 admita la agrupación de conexiones compatibles con controladores debe implementar esta función.

Incluya sqlspi.h para el desarrollo de controladores ODBC.

Consulte también

Desarrollar un controlador ODBC
Agrupación de conexiones dependientes del controlador
Desarrollar el conocimiento de la agrupación de conexiones en un controlador ODBC