SQLPoolConnect 함수

규칙
버전 도입: ODBC 3.8 표준 준수: ODBC

요약
풀에서 연결을 다시 사용할 수 없는 경우 SQLPoolConnect 를 사용하여 새 연결을 만듭니다.

구문

  
SQLRETURN  SQLPoolConnect(  
                SQLHDBC              hDbc,  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              wszOutConnectString,  
                SQLSMALLINT          cchConnectStringBuffer,  
                SQLSMALLINT *        cchConnectStringLen );  

인수

hDbc
[입력] 연결 핸들입니다.

hDbcInfoToken
[입력] 새 애플리케이션 연결 요청에 대한 토큰 핸들입니다.

wszOutConnectString
[출력] 완료된 연결 문자열에 대한 버퍼에 대한 포인터입니다. 대상 데이터 원본에 성공적으로 연결되면 이 버퍼에 완료된 연결 문자열이 포함됩니다. 애플리케이션은 이 버퍼에 대해 1,024자 이상을 할당해야 합니다.

wszOutConnectString이 NULL인 경우 cchConnectStringLen은 wszOutConnectString이 가리키는 버퍼에서 반환할 수 있는 총 문자 수(문자 데이터의 null 종료 문자 제외)를 반환합니다.

cchConnectStringBuffer
[입력] *wszOutConnectString 버퍼의 길이(문자)입니다.

cchConnectStringLen
[출력] *wszOutConnectString에서 반환할 수 있는 총 문자 수(null 종료 문자 제외)를 반환할 버퍼에 대한 포인터입니다. 반환할 수 있는 문자 수가 cchConnectStringBuffer보다 크거나 같으면 *wszOutConnectString의 완료된 연결 문자열이 cchConnectStringBuffer에서 null 종료 문자의 길이를 뺀 값으로 잘립니다.

반품

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 또는 SQL_INVALID_HANDLE.

진단

드라이버 관리자가 SQL_HANDLE_DBC_INFO_TOKEN HandleType 및 hDbcInfoToken 핸들을 사용한다는 점을 제외하고 입력 유효성 검사 오류에 대한 SQLDriverConnect와 유사합니다.

설명

드라이버 관리자는 hDbc 및 hDbcInfoToken의 부모 HENV 핸들이 동일하다는 것을 보장합니다.

SQLDriverConnect와 달리 연결 정보를 입력하라는 메시지를 표시하는 DriverCompletion 인수는 없습니다. 풀링 시나리오에서는 프롬프트 대화 상자가 허용되지 않습니다.

애플리케이션은 이 함수를 직접 호출해서는 안 됩니다. 드라이버 인식 연결 풀링을 지원하는 ODBC 드라이버는 이 함수를 구현해야 합니다.

드라이버가 SQL_ERROR 또는 SQL_INVALID_HANDLE 반환할 때마다 드라이버 관리자는 SQLConnect 또는 SQLDriverConnect에서 애플리케이션에 오류를 반환합니다.

드라이버가 SQL_SUCCESS_WITH_INFO 반환할 때마다 드라이버 관리자는 hDbcInfoToken에서 진단 정보를 가져오고 SQLConnect 및 SQLDriverConnect의 애플리케이션에 SQL_SUCCESS_WITH_INFO 반환합니다.

애플리케이션에서 SQLConnect를 사용하는 경우 wszOutConnectString은 NULL 버퍼가 됩니다(마지막 세 매개 변수는 모두 NULL, 0, NULL로 설정됨). 그렇지 않으면 드라이버는 애플리케이션의 SQLDriverConnect 함수 호출에 반환되는 출력 연결 문자열을 반환해야 합니다.

ODBC 드라이버 개발을 위해 sqlspi.h를 포함합니다.

참고 항목

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