SQLDriverConnect
SQL Native Client ODBC 드라이버는 연결 문자열 키워드를 바꾸거나 기능을 향상시키는 연결 특성을 정의합니다. 여러 연결 문자열 키워드에 SQL Native Client ODBC 드라이버로 지정된 기본값이 있습니다.
SQL Native Client ODBC 드라이버에서 사용할 수 있는 키워드 목록은 Using Connection String Keywords with SQL Native Client을 참조하십시오.
SQL Server 연결 특성 및 드라이버 기본 동작에 대한 자세한 내용은 SQLSetConnectAttr을 참조하십시오.
SQLDriverConnectDriverCompletion 매개 변수 값이 SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE 또는 SQL_DRIVER_COMPLETE_REQUIRED이면 SQL Native Client ODBC 드라이버가 표시된 대화 상자에서 키워드 값을 검색합니다. 키워드 값이 연결 문자열에 전달되고 사용자가 대화 상자의 키워드 값을 변경하지 않으면 SQL Native Client ODBC 드라이버가 연결 문자열의 값을 사용합니다. 값이 연결 문자열에 설정되어 있지 않고 사용자가 대화 상자에서 값을 할당하지 않으면 드라이버는 기본값을 사용합니다.
DriverCompletion 값에 따라 드라이버 연결 대화 상자를 표시해야 하는 경우(또는 그러한 가능성이 있는 경우) SQLDriverConnect에 올바른 WindowHandle을 지정해야 합니다. 잘못된 핸들은 SQL_ERROR를 반환합니다.
DRIVER 또는 DSN 키워드를 지정합니다. ODBC에는 두 키워드가 모두 지정되어 있으면 드라이버가 이러한 두 키워드 중 가장 왼쪽의 키워드를 사용하고 나머지 다른 하나는 무시한다는 설명이 있습니다. DRIVER가 지정되어 있거나 두 키워드 중 가장 왼쪽의 키워드이고 SQLDriverConnectDriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT이면 SERVER 키워드와 적절한 값이 필요합니다.
SQL_DRIVER_NOPROMPT가 지정된 경우 값이 포함된 사용자 인증 키워드가 있어야 합니다. 이 드라이버는 "Trusted_Connection=yes" 문자열이나 UID 및 PWD 키워드가 있는지 확인합니다.
DriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT 또는 SQL_DRIVER_COMPLETE_REQUIRED이고 연결 문자열에서 가져온 언어나 데이터베이스가 잘못된 경우 SQLDriverConnect는 SQL_ERROR를 반환합니다.
DriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT 또는 SQL_DRIVER_COMPLETE_REQUIRED이고 ODBC 데이터 원본 정의에서 가져온 언어나 데이터베이스가 잘못된 경우 SQLDriverConnect는 지정된 사용자 ID의 기본 언어나 데이터베이스를 사용하고 SQL_SUCCESS_WITH_INFO를 반환합니다.
DriverCompletion 매개 변수 값이 SQL_DRIVER_COMPLETE 또는 SQL_DRIVER_PROMPT이고 언어나 데이터베이스가 잘못된 경우 SQLDriverConnect는 대화 상자를 다시 표시합니다.
예
다음 호출에서는 SQLDriverConnect에 필요한 최소 데이터 양을 보여 줍니다.
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) "DRIVER={SQL Native Client};" SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
다음 연결 문자열에서는 DriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT일 때 필요한 최소 데이터를 보여 줍니다.
"DSN=Human Resources;UID=MyUserName;PWD=MyPassword"
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;UID=MyUserName;PWD=MyPassword"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Native Client};SERVER=(local);UID=MyUserName;PWD=MyPassword"
"DRIVER={SQL Native Client};SERVER=(local);Trusted_Connection=yes"
참고 항목
개념
ODBC API Implementation Details
관련 자료
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING(Transact-SQL)
SET ANSI_WARNINGS(Transact-SQL)
SQLDriverConnect 함수