SQLGetPoolID 함수
규칙
버전 도입: ODBC 3.81 표준 준수: ODBC
요약
SQLGetPoolID 는 풀 ID를 검색합니다.
구문
SQLRETURN SQLGetPoolID (
SQLHDBC_INFO_TOKEN hDbcInfoToken,
POOLID * pPoolID );
인수
hDbcInfoToken
[입력] 모든 연결 정보를 포함하는 토큰 핸들입니다.
pPoolID
[출력] 풀 ID는 서로 바꿔 사용할 수 있는 연결 집합을 식별하는 데 사용됩니다(추가 재설정 필요).
반품
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 또는 SQL_INVALID_HANDLE.
진단
SQLGetPoolID가 SQL_ERROR 또는 SQL_SUCCESS_WITH_INFO 반환하면 드라이버 관리자는 SQL_HANDLE_DBC_INFO_TOKEN HandleType 및 hDbcInfoToken의 핸들을 사용합니다.
설명
SQLGetPoolID 는 연결 정보 집합이 지정된 풀 ID를 가져오는 데 사용됩니다( SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo 및 SQLSetConnectInfo에서). 이 풀 ID는 서로 교환하여 사용할 수 있는 연결 집합을 식별하는 데 사용됩니다(추가 재설정 필요). 풀 ID는 해당 연결 그룹의 연결 풀을 식별하는 데 사용됩니다.
드라이버가 SQL_ERROR 또는 SQL_INVALID_HANDLE 반환할 때마다 드라이버 관리자는 SQLConnect 또는 SQLDriverConnect에서 애플리케이션에 오류를 반환합니다.
드라이버가 SQL_SUCCESS_WITH_INFO 반환할 때마다 드라이버 관리자는 hDbcInfoToken에서 진단 정보를 가져오고 SQLConnect 및 SQLDriverConnect의 애플리케이션에 SQL_SUCCESS_WITH_INFO 반환합니다.
애플리케이션은 이 함수를 직접 호출해서는 안 됩니다. 드라이버 인식 연결 풀링을 지원하는 ODBC 드라이버는 이 함수를 구현해야 합니다.
ODBC 드라이버 개발을 위해 sqlspi.h를 포함합니다.