다음을 통해 공유


SQLDriverConnect

SQL Server Native Client ODBC 드라이버는 연결 문자열 키워드를 대체하거나 개선하는 연결 특성을 정의합니다. 몇 가지 연결 문자열 키워드에는 SQL Server Native Client ODBC 드라이버가 지정한 기본값이 있습니다.

SQL Server Native Client ODBC 드라이버에서 사용할 수 있는 키워드 목록은 SQL Server Native Client에서 연결 문자열 키워드 사용를 참조하십시오.

SQL Server 연결 특성 및 드라이버 기본 동작에 대한 자세한 내용은 SQLSetConnectAttr을 참조하십시오.

SQLDriverConnectDriverCompletion 매개 변수 값이 SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE 또는 SQL_DRIVER_COMPLETE_REQUIRED이면 SQL Server Native Client ODBC 드라이버는 표시되는 대화 상자에서 키워드 값을 검색합니다. 키워드 값이 연결 문자열에서 전달되었고 사용자가 대화 상자에서 키워드 값을 변경하지 않은 경우 SQL Server Native Client ODBC 드라이버는 연결 문자열의 값을 사용합니다. 키워드 값이 연결 문자열에서 설정되지 않았고 사용자가 대화 상자에서 키워드 값을 지정하지 않은 경우 드라이버는 기본값을 사용합니다.

DriverCompletion 값이 드라이버 연결 대화 상자가 표시되도록 요구하거나 그럴 가능성이 있는 경우에는 SQLDriverConnect에 유효한 WindowHandle을 지정해야 합니다. 잘못된 핸들을 지정하면 SQL_ERROR가 반환됩니다.

DRIVER 또는 DSN 키워드 중 하나를 지정합니다. 둘 모두 지정한 경우 ODBC 드라이버는 이 두 키워드 중 왼쪽의 키워드를 사용하고 다른 하나는 무시합니다. DRIVER를 지정하거나 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가 대화 상자를 다시 표시합니다.

SPN(서비스 사용자 이름)에 대한 SQLDriverConnect 지원

사용자 확인이 설정된 경우 SQLDDriverConnect는 ODBC 로그인 대화 상자를 사용합니다. 이를 통해 주 서버 및 해당 장애 조치(Failover) 파트너 모두에 대한 SPN이 입력되도록 할 수 있습니다.

SQLDriverConnect는 새 연결 문자열 키워드인 ServerSPN과 FailoverPartnerSPN을 받아들이고 새 연결 특성인 SQL_COPT_SS_SERVER_SPN과 SQL_COPT_SS_FAILOVER_PARTNER_SPN을 인식합니다.

연결 특성 값이 두 번 이상 지정된 경우 프로그래밍 방식으로 설정된 값이 DSN의 값 및 연결 문자열의 값보다 우선 순위가 높고 DSN의 값이 연결 문자열의 값보다 우선 순위가 높습니다.

연결이 열릴 때 SQL Server Native Client는 SQL_COPT_SS_MUTUALLY_AUTHENTICATED 및 SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD를 연결을 여는 데 사용하는 인증 방법으로 설정합니다.

SPN에 대한 자세한 내용은 클라이언트 연결(ODBC)의 SPN(서비스 사용자 이름)을 참조하십시오.

다음 호출은 SQLDriverConnect에 필요한 최소한의 데이터를 보여 줍니다.

SQLDriverConnect(hdbc, hwnd,
    (SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);

다음 연결 문자열은 DriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT인 경우 필요한 최소한의 데이터를 보여 줍니다.

"DSN=Human Resources;Trusted_Connection=yes"

"FILEDSN=HR_FDSN;Trusted_Connection=yes"

"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"