Compartir a través de

Función SQLCleanupConnectionPoolID

  • Artículo

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

Resumen
SQLCleanupConnectionPoolID informa a un controlador de que se agotó el tiempo de espera de un identificador de grupo. Un identificador de grupo puede agotar el tiempo de espera cada vez que se agote el tiempo de espera de todas las conexiones de un grupo asociado a ese identificador de grupo. Consulte Agrupación en Microsoft Data Access Components para obtener más información sobre el tiempo de espera de conexión.

Sintaxis

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Argumentos

EnvironmentHandle
[Entrada] Identificador de entorno del grupo.

PoolID
[Entrada] Grupo asociado al identificador del grupo que se agotó el tiempo de espera.

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnóstico

El Administrador de controladores no procesará la información de diagnóstico devuelta desde SQLCleanupConnectionPoolID.

Una aplicación no puede recibir el mensaje de error devuelto por el controlador.

Comentarios

Se puede llamar a SQLCleanupConnectionPoolID en cualquier momento, pero el Administrador de controladores garantiza que ningún otro subproceso llama simultáneamente a SQLGetPoolID y ningún otro subproceso llama simultáneamente a SQLRateConnection y SQLPoolConnect con un token de información de conexión asignado con ese identificador de grupo. Por lo tanto, el controlador debe asegurarse de que esta función es segura para subprocesos.

Un controlador puede limpiar los recursos asociados al identificador del grupo.

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