SQLDriverConnect

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

SQL Server Native Client ODBC 드라이버는 연결 문자열 키워드(keyword) 바꾸거나 향상시키는 연결 특성을 정의합니다. 여러 연결 문자열 키워드(keyword) SQL Server Native Client ODBC 드라이버에서 지정한 기본값을 갖습니다.

SQL Server Native Client ODBC 드라이버에서 사용할 수 있는 키워드(keyword) 목록은 SQL Server Native Client에서 커넥트ion 문자열 키워드 사용을 참조하세요.

SQL Server 연결 특성 및 드라이버 기본 동작에 대한 자세한 내용은 SQLSet커넥트Attr을 참조하세요.

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

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

DriverCompletion 값이 드라이버의 연결 대화 상자를 표시해야 하거나 필요할 수 있는 경우 SQLDriver커넥트 유효한 WindowHandle을 제공해야 합니다. 잘못된 핸들은 SQL_ERROR 반환합니다.

DRIVER 또는 DSN 키워드(keyword) 지정합니다. ODBC는 드라이버가 이 두 키워드(keyword) 맨 왼쪽을 사용하고 둘 다 지정된 경우 다른 키워드(keyword) 무시한다고 명시하고 있습니다. DRIVER가 지정되었거나 둘 중 가장 왼쪽이고 SQLDriver커넥트DriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT 경우 SERVER 키워드(keyword) 적절한 값이 필요합니다.

SQL_DRIVER_NOPROMPT를 지정하는 경우에는 사용자 인증 키워드를 값과 함께 제공해야 합니다. 드라이버는 문자열 "Trusted_Connection=yes" 또는 UID와 PWD 키워드가 제공되었는지 확인합니다.

DriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT 또는 SQL_DRIVER_COMPLETE_REQUIRED 언어 또는 데이터베이스가 연결 문자열 제공되고 잘못된 경우 SQLDriver커넥트 SQL_ERROR 반환합니다.

DriverCompletion 매개 변수 값이 SQL_DRIVER_NOPROMPT 또는 SQL_DRIVER_COMPLETE_REQUIRED 언어 또는 데이터베이스가 ODBC 데이터 원본 정의에서 제공되고 잘못된 경우 SQLDriver커넥트 지정된 사용자 ID에 대한 기본 언어 또는 데이터베이스를 사용하고 SQL_SUCCESS_WITH_INFO 반환합니다.

DriverCompletion 매개 변수 값이 SQL_DRIVER_COMPLETE 또는 SQL_DRIVER_PROMPT 언어 또는 데이터베이스가 잘못된 경우 SQLDriver커넥트 대화 상자를 다시 표시합니다.

SQLDriver커넥트 고가용성 재해 복구 지원

SQLDriver커넥트를 사용하여 Always On 가용성 그룹 클러스터에 연결하는 방법에 대한 자세한 내용은 고가용성 재해 복구에 대한 SQL Server Native Client 지원을 참조 하세요.

SQLDriver커넥트 SPN(서비스 사용자 이름) 지원

SQLDDriver커넥트 ODBC 로그인 대화 상자를 사용하고 프롬프트를 사용하도록 설정합니다. 이렇게 하면 주 서버와 해당 장애 조치(failover) 파트너 모두에 대해 SPN을 입력할 수 있습니다.

SQLDriver커넥트 새 연결 문자열 키워드(keyword)s 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(클라이언트 커넥트ions)의 SPN(서비스 사용자 이름)을 참조하세요.

예제

다음 호출에서는 SQLDriver커넥트 필요한 최소 데이터 양을 보여 줍니다.

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"  

참고 항목

SQLDriver커넥트 함수
ODBC API 구현 정보
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING(Transact-SQL)
SET ANSI_WARNINGS(Transact-SQL)