SQLCleanupConnectionPoolID 함수
규칙
버전 도입: ODBC 3.81 표준 준수: ODBC
요약
SQLCleanupConnectionPoolID는 풀 ID가 시간 초과되었음을 드라이버에 알릴 수 있습니다. 풀 ID는 해당 풀 ID와 연결된 풀의 모든 연결 시간이 초과될 때마다 시간 초과될 수 있습니다. 연결 시간 제한에 대한 자세한 내용은 Microsoft 데이터 액세스 구성 요소의 풀링을 참조하세요.
구문
SQLRETURN SQLCleanupConnectionPoolID (
SQLHENV EnvironmentHandle
SQLPOOLID PoolID );
인수
EnvironmentHandle
[입력] 풀의 환경 핸들입니다.
PoolID
[입력] 시간이 초과된 풀 ID에 연결된 풀입니다.
반품
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 또는 SQL_INVALID_HANDLE.
진단
드라이버 관리자는 SQLCleanupConnectionPoolID에서 반환된 진단 정보를 처리하지 않습니다.
애플리케이션이 드라이버에서 반환한 오류 메시지를 받을 수 없습니다.
설명
SQLCleanupConnectionPoolID는 언제든지 호출할 수 있지만 드라이버 관리자는 다른 스레드가 동시에 SQLGetPoolID를 호출하지 않고 다른 스레드가 해당 풀 ID로 할당된 연결 정보 토큰을 사용하여 SQLRateConnection 및 SQLPoolConnect를 동시에 호출하지 않음을 보장합니다. 따라서 드라이버는 이 함수가 스레드로부터 안전한지 확인해야 합니다.
드라이버는 풀 ID와 연결된 리소스를 정리할 수 있습니다.
애플리케이션은 이 함수를 직접 호출해서는 안 됩니다. 드라이버 인식 연결 풀링을 지원하는 ODBC 드라이버는 이 함수를 구현해야 합니다.
ODBC 드라이버 개발을 위해 sqlspi.h를 포함합니다.