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.
진단
설명
드라이버 관리자는 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를 포함합니다.