다음을 통해 공유

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를 포함합니다.

참고 항목

ODBC 드라이버 개발
드라이버 인식 연결 풀링
ODBC 드라이버에서 연결 풀 인식 개발