Función SQLCleanupConnectionPoolID

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

Summary
SQLCleanupConnectionPoolID informa a un controlador de que un ID de pool ha estado agotado. Un ID de pool puede expirar cada vez que todas las conexiones de un pool asociadas a ese ID de pool hayan estado agotadas. Consulta Pooling en los Componentes de Acceso a Datos de Microsoft para más información sobre el tiempo de espera de conexión.

Sintaxis

  
SQLRETURN  SQLCleanupConnectionPoolID (  
                SQLHENV    EnvironmentHandle  
                SQLPOOLID  PoolID );

Argumentos

EnvironmentHandle
[Entrada] El control ambiental de la piscina.

PoolID
[Entrada] El pool asociado al ID del pool que estaba agotado.

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnósticos

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.

Remarks

Se puede llamar a SQLCleanupConnectionPoolID en cualquier momento, pero el Administrador de Controladores garantiza que ningún otro hilo esté llamando simultáneamente a SQLGetPoolID y que ningún otro hilo llame simultáneamente a SQLRateConnection y SQLPoolConnect con un token de información de conexión asignado a ese ID de pool. Por lo tanto, el controlador debe asegurarse de que esta función sea segura para roscas.

Un conductor puede limpiar los recursos asociados al ID del pool.

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