SQLSetDriverConnectInfo 함수

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

요약
SQLSetDriverConnectInfo 는 연결 문자열을 애플리케이션의 SQLDriverConnect 호출에 대한 연결 정보 토큰으로 설정하는 데 사용됩니다.

구문

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );  

인수

TokenHandle
[입력] 토큰 핸들입니다.

InConnectionString
[입력] 전체 연결 문자열(SQLDriverConnect의 "Comments"의 구문 참조), 부분 연결 문자열 또는 빈 문자열입니다.

StringLength1
[입력] *InConnectionString의 길이(문자열이 유니코드인 경우 문자) 또는 문자열이 ANSI 또는 DBCS인 경우 바이트입니다.

반품

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 또는 SQL_INVALID_HANDLE.

진단

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

설명

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

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

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

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

참고 항목

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