SQLSetConnectInfo 함수

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

요약
SQLSetConnectInfo 는 데이터 원본, 사용자 ID 및 암호를 애플리케이션의 SQLConnect 호출에 대한 연결 정보 토큰으로 설정하는 데 사용됩니다.

구문

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );  

인수

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

데이터 열이 추적에서 캡처되고 서버를 사용할 수 있으면
[입력] 데이터 원본 이름입니다. 데이터는 프로그램과 동일한 컴퓨터 또는 네트워크의 다른 컴퓨터에 있을 수 있습니다. 애플리케이션에서 데이터 원본을 선택하는 방법에 대한 자세한 내용은 데이터 원본 또는 드라이버 선택을 참조하세요.

NameLength1
[입력] *ServerName 문자의 길이입니다.

UserName
[입력] 사용자 식별자입니다.

NameLength2
[입력] *UserName 문자의 길이입니다.

인증
[입력] 인증 문자열(일반적으로 암호).

NameLength3
[입력] *문자의 인증 길이입니다.

반품

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 또는 SQL_INVALID_HANDLE.

진단

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

설명

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

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

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

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

참고 항목

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