SQLDriverConnect

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

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

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

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

SQL Server Native Client에 유효한 연결 문자열 키워드에 대한 자세한 내용은 SQL Server Native Client에서 연결 문자열 키워드 사용을 참조하세요.

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

드라이버 완성 값에 드라이버 연결 대화 상자 표시가 필요하거나 필요할 수 있는 경우 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를 사용하여 Always On 가용성 그룹 클러스터에 연결하는 방법에 대한 자세한 내용은 고가용성 재해 복구에 대한 SQL Server Native Client 지원을 참조 하세요.

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"  

참고 항목

SQLDriverConnect 함수
ODBC API 구현 정보
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING(Transact-SQL)
SET ANSI_WARNINGS(Transact-SQL)