Share via

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

참고 항목

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