SQLBrowseConnect 함수

아티클
07/04/2024

규칙
도입된 버전: ODBC 1.0 표준 준수: ODBC

요약
SQLBrowseConnect 는 데이터 원본에 연결하는 데 필요한 특성 및 특성 값을 검색하고 열거하는 반복 메서드를 지원합니다. SQLBrowseConnect에 대한 각 호출은 특성 및 특성 값의 연속적인 수준을 반환합니다. 모든 수준이 열거되면 데이터 원본에 대한 연결이 완료되고 SQLBrowseConnect에서 전체 연결 문자열 반환됩니다. SQL_SUCCESS 또는 SQL_SUCCESS_WITH_INFO 반환 코드는 모든 연결 정보가 지정되었고 애플리케이션이 이제 데이터 원본에 연결되었음을 나타냅니다.

구문

  
SQLRETURN SQLBrowseConnect(  
     SQLHDBC         ConnectionHandle,  
     SQLCHAR *       InConnectionString,  
     SQLSMALLINT     StringLength1,  
     SQLCHAR *       OutConnectionString,  
     SQLSMALLINT     BufferLength,  
     SQLSMALLINT *   StringLength2Ptr);

인수

ConnectionHandle
[Input] 연결 핸들입니다.

InConnectionString
[입력] 요청 연결 문자열 찾아보기("주석"의 "InConnectionString 인수" 참조).

StringLength1
[입력] *InConnectionString 문자의 길이입니다.

OutConnectionString
[출력] 찾아보기 결과 연결 문자열 반환할 문자 버퍼에 대한 포인터입니다("Comments"의 "OutConnectionString Argument" 참조).

OutConnectionString이 NULL인 경우 StringLength2Ptr은 OutConnectionString이 가리키는 버퍼에서 반환할 수 있는 총 문자 수(문자 데이터의 null 종료 문자 제외)를 계속 반환합니다.

BufferLength
[입력] *OutConnectionString 버퍼의 길이(문자)입니다.

StringLength2Ptr
[출력] *OutConnectionString에서 반환할 수 있는 총 문자 수(null 종료 제외)입니다. 반환할 수 있는 문자 수가 BufferLength보다 크거나 같으면 *OutConnectionString의 연결 문자열 BufferLength에서 null 종료 문자의 길이를 뺀 값으로 잘립니다.

반품

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_NEED_DATA, SQL_ERROR, SQL_INVALID_HANDLE 또는 SQL_STILL_EXECUTING.

진단

SQLBrowseConnect가 SQL_ERROR, SQL_SUCCESS_WITH_INFO 또는 SQL_NEED_DATA 반환하는 경우 SQL_HANDLE_STMT HandleType 및 ConnectionHandle 핸들을 사용하여 SQLGetDiagRec 를 호출하여 연결된 SQLSTATE 값을 가져올 수 있습니다. 다음 표에서는 SQLBrowseConnect에서 일반적으로 반환되는 SQLSTATE 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다. 표기법 "(DM)"은 드라이버 관리자가 반환한 SQLSTATE에 대한 설명 앞에 나와 있습니다. 달리 명시되지 않는 한 각 SQLSTATE 값과 연결된 반환 코드는 SQL_ERROR.

SQLSTATE	오류	설명
01000	일반 경고	드라이버 관련 정보 메시지입니다. 함수는 SQL_SUCCESS_WITH_INFO 반환합니다.
01004	문자열 데이터, 오른쪽 잘림	버퍼 *OutConnectionString이 전체 찾아보기 결과 연결 문자열 반환할 만큼 충분히 크지 않으므로 문자열이 잘렸습니다. 버퍼 *StringLength2Ptr에는 신뢰할 수 없는 찾아보기 결과 연결 문자열 길이가 포함됩니다. 함수는 SQL_NEED_DATA 반환합니다.
01S00	잘못된 연결 문자열 특성	찾아보기 요청 연결 문자열 잘못된 특성 키워드가 지정되었습니다(InConnectionString). 함수는 SQL_NEED_DATA 반환합니다. 현재 연결 수준에 적용되지 않는 찾아보기 요청 연결 문자열(InConnectionString)에 특성 키워드가 지정되었습니다. 함수는 SQL_NEED_DATA 반환합니다.
01S02	변경된 값	드라이버는 SQLSetConnectAttr에서 ValuePtr 인수의 지정된 값을 지원하지 않고 비슷한 값을 대체했습니다. 함수는 SQL_SUCCESS_WITH_INFO 반환합니다.
08001	클라이언트가 연결을 설정할 수 없음	드라이버가 데이터 원본과의 연결을 설정할 수 없습니다.
08002	사용 중인 연결 이름	(DM) 지정된 연결이 데이터 원본과의 연결을 설정하는 데 이미 사용되었으며 연결이 열려 있었습니다.
08004	서버에서 연결을 거부했습니다.	데이터 원본에서 구현 정의 이유로 연결 설정이 거부되었습니다.
08S01	통신 링크 실패	드라이버와 연결하려는 데이터 원본 간의 통신 링크가 함수 처리를 완료하기 전에 실패했습니다.
28000	잘못된 권한 부여 사양	찾아보기 요청 연결 문자열(InConnectionString)에 지정된 사용자 식별자 또는 권한 부여 문자열 또는 둘 다 데이터 원본에서 정의한 제한을 위반했습니다.
HY000	일반 오류	특정 SQLSTATE가 없고 구현별 SQLSTATE가 정의되지 않은 오류가 발생했습니다. *MessageText 버퍼의 SQLGetDiagRec에서 반환된 오류 메시지는 오류와 그 원인을 설명합니다.
HY001	메모리 할당 오류	(DM) 드라이버 관리자가 함수 실행 또는 완료를 지원하는 데 필요한 메모리를 할당할 수 없습니다. 드라이버가 함수 실행 또는 완료를 지원하는 데 필요한 메모리를 할당할 수 없습니다.
HY008	작업이 취소됨	SQLCancelHandle 함수를 호출하여 비동기 작업이 취소되었습니다. 그런 다음, ConnectionHandle에서 원래 함수가 다시 호출되었습니다. 다중 스레드 애플리케이션의 다른 스레드에서 ConnectionHandle에서 SQLCancelHandle을 호출하여 작업이 취소되었습니다.
HY010	함수 시퀀스 오류	(DM) ConnectionHandle에 대해 비동기 실행 함수(이 함수가 아님)가 호출되었고 이 함수가 호출되었을 때 계속 실행되고 있었습니다.
HY013	메모리 관리 오류	메모리 조건이 낮기 때문에 기본 메모리 개체에 액세스할 수 없기 때문에 함수 호출을 처리할 수 없습니다.
HY090	잘못된 문자열 또는 버퍼 길이	(DM) StringLength1 인수에 지정된 값이 0보다 작고 SQL_NTS 같지 않습니다. (DM) BufferLength 인수에 지정된 값이 0보다 작습니다.
HY114	드라이버는 연결 수준 비동기 함수 실행을 지원하지 않습니다.	(DM) 애플리케이션은 연결을 만들기 전에 연결 핸들에서 비동기 작업을 사용하도록 설정했습니다. 그러나 드라이버는 연결 핸들에 대한 비동기 작업을 지원하지 않습니다.
HYT00	시간 제한 만료됨	데이터 원본에 대한 연결이 완료되기 전에 로그인 제한 시간이 만료되었습니다. 시간 제한 기간은 SQL_ATTR_LOGIN_TIMEOUT SQLSetConnectAttr를 통해 설정됩니다.
HYT01	연결 제한 시간이 만료됨	데이터 원본이 요청에 응답하기 전에 연결 제한 시간이 만료되었습니다. 연결 제한 시간은 SQL_ATTR_CONNECTION_TIMEOUT SQLSetConnectAttr를 통해 설정됩니다.
IM001	드라이버는 이 함수를 지원하지 않습니다.	(DM) 지정된 데이터 원본 이름에 해당하는 드라이버는 함수를 지원하지 않습니다.
IM002	데이터 원본을 찾을 수 없고 기본 드라이버가 지정되지 않음	(DM) 찾아보기 요청 연결 문자열 지정된 데이터 원본 이름(InConnectionString)을 시스템 정보에서 찾을 수 없으며 기본 드라이버 사양도 없습니다. (DM) 시스템 정보에서 ODBC 데이터 원본 및 기본 드라이버 정보를 찾을 수 없습니다.
IM003	지정된 드라이버를 로드할 수 없습니다.	(DM) 시스템 정보의 데이터 원본 사양에 나열되거나 DRIVER 키워드로 지정된 드라이버를 찾을 수 없거나 다른 이유로 로드할 수 없습니다.
IM004	SQL_HANDLE _ENV 드라이버의 SQLAllocHandle 이 실패했습니다.	(DM) SQLBrowseConnect 중에 드라이버 관리자는 SQL_HANDLE_ENV HandleType을 사용하여 드라이버의 SQLAllocHandle 함수를 호출했고 드라이버는 오류를 반환했습니다.
IM005	SQL_HANDLE_DBC 드라이버의 SQLAllocHandle 이 실패했습니다.	(DM) SQLBrowseConnect 중에 드라이버 관리자는 SQL_HANDLE_DBC HandleType을 사용하여 드라이버의 SQLAllocHandle 함수를 호출했고 드라이버는 오류를 반환했습니다.
IM006	드라이버의 SQLSetConnectAttr 실패	(DM) SQLBrowseConnect 중에 드라이버 관리자가 드라이버의 SQLSetConnectAttr 함수를 호출하고 드라이버가 오류를 반환했습니다.
IM009	번역 DLL을 로드할 수 없음	드라이버가 데이터 원본 또는 연결에 대해 지정된 변환 DLL을 로드할 수 없습니다.
IM010	데이터 원본 이름이 너무 깁니다.	(DM) DSN 키워드의 특성 값이 SQL_MAX_DSN_LENGTH 문자보다 깁니다.
IM011	드라이버 이름이 너무 깁니다.	(DM) DRIVER 키워드의 특성 값이 255자보다 깁니다.
IM012	DRIVER 키워드 구문 오류	(DM) DRIVER 키워드의 키워드-값 쌍에 구문 오류가 포함되어 있습니다.
IM014	지정된 DSN에는 드라이버와 애플리케이션 간의 아키텍처 불일치가 포함되어 있습니다.	(DM) 32비트 애플리케이션은 64비트 드라이버에 연결하는 DSN을 사용합니다. 또는 그 반대의 경우도 마찬가지입니다.
IM017	비동기 알림 모드에서 폴링을 사용할 수 없습니다.	알림 모델을 사용할 때마다 폴링이 비활성화됩니다.
IM018	이 핸들에서 이전 비동기 작업을 완료하기 위해 SQLCompleteAsync 가 호출되지 않았습니다.	핸들의 이전 함수 호출이 SQL_STILL_EXECUTING 반환하고 알림 모드가 활성화된 경우 사후 처리를 수행하고 작업을 완료하려면 핸들에서 SQLCompleteAsync 를 호출해야 합니다.
S1118	드라이버는 비동기 알림을 지원하지 않습니다.	드라이버가 비동기 알림을 지원하지 않는 경우 SQL_ATTR_ASYNC_DBC_EVENT 또는 SQL_ATTR_ASYNC_DBC_RETCODE_PTR 설정할 수 없습니다.

InConnectionString 인수

찾아보기 요청 연결 문자열 구문은 다음과 같습니다.

connection-string ::= attribute[;] | 특성 ; 연결 문자열;
attribute ::= attribute-keyword=attribute-valueDRIVER= | [{]attribute-value[}]
attribute-keyword ::= DSNPWD | UID | | driver-defined-attribute-keyword
attribute-value ::= character-string
driver-defined-attribute-keyword ::= 식별자

여기서 문자 문자열에는 0개 이상의 문자 가 있습니다.식별자에는 하나 이상의 문자가 있습니다. attribute-keyword는 대/소문자를 구분 하지 않습니다.특성 값은 대/소문자를 구분할 수 있으며 DSN 키워드 값은 공백으로만 구성되지 않습니다. 연결 문자열 및 초기화 파일 문법으로 인해 문자 []{}(),;가 포함된 키워드 및 특성 값이 있나요? *=!@은(는) 피해야 합니다. 시스템 정보의 문법 때문에 키워드 및 데이터 원본 이름에는 백슬래시(\) 문자를 포함할 수 없습니다. ODBC 2의 경우x 드라이버, DRIVER 키워드의 특성 값 주위에 중괄호가 필요합니다.

찾아보기 요청 연결 문자열 키워드가 반복되면 드라이버는 키워드의 첫 번째 발생과 연결된 값을 사용합니다. DSN 및 DRIVER 키워드가 동일한 찾아보기 요청 연결 문자열 포함된 경우 드라이버 관리자와 드라이버는 먼저 표시되는 키워드를 사용합니다.

애플리케이션에서 데이터 원본 또는 드라이버를 선택하는 방법에 대한 자세한 내용은 데이터 원본 또는 드라이버 선택을 참조하세요.

OutConnectionString 인수

연결 문자열 찾아보기 결과는 연결 특성 목록입니다. 연결 특성은 특성 키워드와 해당 특성 값으로 구성됩니다. 찾아보기 결과 연결 문자열 구문은 다음과 같습니다.

connection-string ::= attribute[;] | 특성 ; 연결 문자열
attribute ::= [*]attribute-keyword=attribute-value
attribute-keyword ::= ODBC-attribute-keyword | driver-defined-attribute-keyword
ODBC-attribute-keyword = {UIDPWD | }[:localized-identifier] driver-defined-attribute-keyword ::= identifier[:localized-identifier] attribute-value ::= { attribute-value-list } | ? (중괄호는 리터럴이고 드라이버에서 반환됩니다.)
attribute-value-list ::= character-string [:localized-character string] | character-string [:localized-character string] , attribute-value-list

여기서 문자 문자열 및 지역화된 문자열에는 0개 이상의 문자 가 있습니다.식별자와 지역화된 식별자에 는 하나 이상의 문자 가 있습니다.attribute-keyword는 대/소문자를 구분하지 않으며 특성-값은 대/소문자를 구분할 수 있습니다. 연결 문자열 및 초기화 파일 문법, 키워드, 지역화된 식별자 및 문자 []{}(),;가 포함된 특성 값으로 인해 *=!@은(는) 피해야 합니다. 시스템 정보의 문법 때문에 키워드 및 데이터 원본 이름에는 백슬래시(\) 문자를 포함할 수 없습니다.

찾아보기 결과 연결 문자열 구문은 다음 의미 체계 규칙에 따라 사용됩니다.

별표(*)가 특성 키워드 앞에 오는 경우 특성은 선택 사항이며 SQLBrowseConnect에 대한 다음 호출에서 생략할 수 있습니다.
특성 키워드 UID 및 PWD는 SQLDriverConnect에 정의된 것과 동일한 의미를 갖습니다.
드라이버 정의-특성 키워드는 특성 값을 제공할 수 있는 특성의 종류 이름을 지정합니다. 예를 들어 서버, 데이터베이스, 호스트 또는 DBMS일 수 있습니다.
ODBC-attribute-keywords 및 driver-defined-attribute-keywords 에는 지역화되거나 사용자에게 친숙한 버전의 키워드가 포함됩니다. 이는 애플리케이션에서 대화 상자의 레이블로 사용할 수 있습니다. 그러나 찾아보기 요청 문자열을 드라이버에 전달할 때 UID, PWD 또는 식별자만 사용해야 합니다.
{attribute-value-list}는 해당 특성 키워드에 유효한 실제 값의 열거형입니다. 중괄호({})는 선택 목록을 나타내지 않으며 드라이버에서 반환합니다. 예를 들어 서버 이름 목록 또는 데이터베이스 이름 목록일 수 있습니다.
특성 값이 단일 물음표(?)인 경우 단일 값은 특성 키워드에 해당합니다. 예를 들어 UID=JohnS; PWD=세서미.
SQLBrowseConnect에 대한 각 호출은 연결 프로세스의 다음 수준을 충족하는 데 필요한 정보만 반환합니다. 드라이버는 각 호출에서 컨텍스트를 항상 확인할 수 있도록 상태 정보를 연결 핸들에 연결합니다.

SQLBrowseConnect 사용

SQLBrowseConnect 에는 할당된 연결이 필요합니다. 드라이버 관리자는 초기 찾아보기 요청 연결 문자열 지정된 데이터 원본 이름에 해당하는 드라이버를 로드합니다. 이 경우 자세한 내용은 SQLConnect 함수의 "주석" 섹션을 참조하세요. 드라이버는 검색 프로세스 중에 데이터 원본과의 연결을 설정할 수 있습니다. SQLBrowseConnect가 SQL_ERROR 반환하면 미해결 연결이 종료되고 연결이 연결되지 않은 상태로 반환됩니다.

참고 항목

SQLBrowseConnect 는 연결 풀링을 지원하지 않습니다. 연결 풀링을 사용하는 동안 SQLBrowseConnect가 호출되면 SQLSTATE HY000(일반 오류)이 반환됩니다.

연결에서 SQLBrowseConnect를 처음으로 호출하는 경우 찾아보기 요청 연결 문자열 DSN 키워드 또는 DRIVER 키워드를 포함해야 합니다. 찾아보기 요청 연결 문자열 DSN 키워드가 포함된 경우 드라이버 관리자는 시스템 정보에서 해당 데이터 원본 사양을 찾습니다.

드라이버 관리자가 해당 데이터 원본 사양을 찾으면 연결된 드라이버 DLL을 로드합니다. 드라이버는 시스템 정보에서 데이터 원본에 대한 정보를 검색할 수 있습니다.
드라이버 관리자가 해당 데이터 원본 사양을 찾을 수 없는 경우 기본 데이터 원본 사양을 찾아 연결된 드라이버 DLL을 로드합니다. 드라이버는 시스템 정보에서 기본 데이터 원본에 대한 정보를 검색할 수 있습니다. "DEFAULT"는 DSN용 드라이버에 전달됩니다.
드라이버 관리자가 해당 데이터 원본 사양을 찾을 수 없고 기본 데이터 원본 사양이 없는 경우 SQLSTATE IM002를 사용하여 SQL_ERROR 반환합니다(데이터 원본을 찾을 수 없고 기본 드라이버가 지정되지 않음).

찾아보기 요청 연결 문자열 DRIVER 키워드가 포함된 경우 드라이버 관리자는 지정된 드라이버를 로드합니다. 시스템 정보에서 데이터 원본을 찾으려고 시도하지 않습니다. DRIVER 키워드는 시스템 정보의 정보를 사용하지 않으므로 드라이버가 찾아보기 요청 연결 문자열 정보만 사용하여 데이터 원본에 연결할 수 있도록 충분한 키워드를 정의해야 합니다.

SQLBrowseConnect에 대한 각 호출에서 애플리케이션은 찾아보기 요청 연결 문자열 연결 특성 값을 지정합니다. 드라이버는 찾아보기 결과 연결 문자열 연속적인 수준의 특성 및 특성 값을 반환합니다. 찾아보기 요청 연결 문자열 아직 열거되지 않은 연결 특성이 있는 한 SQL_NEED_DATA 반환합니다. 애플리케이션은 찾아보기 결과 연결 문자열 콘텐츠를 사용하여 SQLBrowseConnect에 대한 다음 호출에 대한 찾아보기 요청 연결 문자열 빌드합니다. 모든 필수 특성(OutConnectionString 인수의 별표 앞에 없는 특성)은 SQLBrowseConnect에 대한 다음 호출에 포함되어야 합니다. 애플리케이션은 현재 찾아보기 요청 연결 문자열 빌드할 때 이전 찾아보기 결과 연결 문자열 내용을 사용할 수 없습니다. 즉, 이전 수준에서 설정된 특성에 대해 다른 값을 지정할 수 없습니다.

모든 수준의 연결 및 관련 특성이 열거되면 드라이버는 SQL_SUCCESS 반환하고, 데이터 원본에 대한 연결이 완료되고, 완전한 연결 문자열 애플리케이션에 반환됩니다. 연결 문자열 SQLDriverConnect와 함께 SQL_DRIVER_NOPROMPT 옵션을 사용하여 다른 연결을 설정하는 데 적합합니다. 전체 연결 문자열 SQLBrowseConnect에 대한 다른 호출에서 사용할 수는 없지만 SQLBrowseConnect를 다시 호출한 경우 전체 호출 시퀀스를 반복해야 합니다.

또한 SQLBrowseConnect 는 찾아보기 프로세스 중에 복구할 수 있는 심각하지 않은 오류가 있는 경우(예: 애플리케이션에서 제공한 잘못된 암호 또는 특성 키워드) SQL_NEED_DATA 반환합니다. SQL_NEED_DATA 반환되고 찾아보기 결과 연결 문자열 변경되지 않은 경우 오류가 발생하고 애플리케이션에서 SQLGetDiagRec를 호출하여 SQLSTATE를 반환하여 검색 시간 오류를 반환할 수 있습니다. 이렇게 하면 애플리케이션에서 특성을 수정하고 찾아보기를 계속할 수 있습니다.

애플리케이션은 SQLDisconnect를 호출하여 언제든지 찾아보기 프로세스를 종료할 수 있습니다. 드라이버는 미해결 연결을 종료하고 연결이 연결되지 않은 상태로 돌아갑니다.

연결 핸들 에서 비동기 작업을 사용하는 경우 SQLBrowseConnect 도 SQL_STILL_EXECUTING 반환할 수 있습니다. SQL_NEED_DATA 반환하는 경우 애플리케이션은 SQLDisconnect를 사용하여 찾아보기 프로세스를 취소해야 합니다. SQLBrowseConnect가 SQL_STILL_EXECUTING 반환하는 경우 애플리케이션은 SQLCancelHandle을 사용하여 진행 중인 작업을 취소해야 합니다. 함수가 SQL_NEED_DATA 반환한 후 SQLCancelHandle을 호출해도 아무런 효과가 없습니다.

자세한 내용은 SQLBrowseConnect를 사용하여 연결을 참조 하세요.

드라이버가 SQLBrowseConnect를 지원하는 경우 드라이버에 대한 시스템 정보의 드라이버 키워드 섹션에 세 번째 문자가 "Y"로 설정된 ConnectFunctions 키워드가 포함되어야 합니다.

코드 예

참고 항목

Windows 인증 지원하는 데이터 원본 공급자에 연결하는 경우 연결 문자열 사용자 ID 및 암호 정보 대신 지정 Trusted_Connection=yes 해야 합니다.

다음 예제에서는 애플리케이션이 SQLBrowseConnect를 반복적으로 호출합니다. SQLBrowseConnect는 SQL_NEED_DATA 반환할 때마다 *OutConnectionString에 필요한 데이터에 대한 정보를 다시 전달합니다. 애플리케이션은 OutConnectionString을 해당 루틴 GetUserInput에 전달합니다(표시되지 않음). GetUserInput 은 정보를 구문 분석하고, 대화 상자를 작성 및 표시하며, *InConnectionString에서 사용자가 입력한 정보를 반환합니다. 애플리케이션은 SQLBrowseConnect에 대한 다음 호출에서 사용자의 정보를 드라이버에 전달합니다. 애플리케이션이 드라이버가 데이터 원본 에 연결하는 데 필요한 모든 정보를 제공한 후 SQLBrowseConnect 는 SQL_SUCCESS 반환하고 애플리케이션이 진행됩니다.

SQLBrowseConnect를 호출하여 SQL Server 드라이버에 연결하는 자세한 예제는 SQL Server 브라우징 예제를 참조하세요.

예를 들어 데이터 원본 Sales에 연결하려면 다음 작업이 발생할 수 있습니다. 먼저 애플리케이션은 SQLBrowseConnect에 다음 문자열을 전달합니다.

"DSN=Sales"

드라이버 관리자는 데이터 원본 Sales와 연결된 드라이버를 로드합니다. 그런 다음 애플리케이션에서 받은 것과 동일한 인수를 사용하여 드라이버의 SQLBrowseConnect 함수를 호출합니다. 드라이버는 *OutConnectionString에서 다음 문자열을 반환합니다.

"HOST:Server={red,blue,green};UID:ID=?;PWD:Password=?"

애플리케이션은 이 문자열을 GetUserInput 루틴에 전달합니다. 이 루틴은 사용자에게 빨간색, 파란색 또는 녹색 서버를 선택하고 사용자 ID 및 암호를 입력하도록 요청하는 대화 상자를 작성합니다. 루틴은 애플리케이션이 SQLBrowseConnect에 전달하는 *InConnectionString에서 다음 사용자 지정 정보를 다시 전달합니다.

"HOST=red;UID=Smith;PWD=Sesame"

SQLBrowseConnect 는 이 정보를 사용하여 암호 세서미를 사용하여 Red Server에 Smith로 연결한 다음 *OutConnectionString에서 다음 문자열을 반환합니다.

"*DATABASE:Database={SalesEmployees,SalesGoals,SalesOrders}"

애플리케이션은 이 문자열을 GetUserInput 루틴에 전달합니다. 이 루틴은 사용자에게 데이터베이스를 선택하도록 요청하는 대화 상자를 작성합니다. 사용자는 empdata를 선택하고 애플리케이션은 이 문자열을 사용하여 SQLBrowseConnect를 마지막으로 호출합니다.

"DATABASE=SalesOrders"

드라이버가 데이터 원본에 연결하는 데 필요한 마지막 정보입니다. SQLBrowseConnect는 SQL_SUCCESS 반환하고 *OutConnectionString에는 완료된 연결 문자열 포함됩니다.

// SQLBrowseConnect_Function.cpp  
// compile with: odbc32.lib  
#include <windows.h>  
#include <sqltypes.h>  
#include <sqlext.h>  
  
#define BRWS_LEN 100  
SQLHENV henv;  
SQLHDBC hdbc;  
SQLHSTMT hstmt;  
SQLRETURN retcode;  
SQLCHAR szConnStrIn[BRWS_LEN], szConnStrOut[BRWS_LEN];  
SQLSMALLINT cbConnStrOut;  
  
void GetUserInput(SQLCHAR * szConnStrOut, SQLCHAR * szConnStrIn) {}  
  
int main() {  
   // Allocate the environment handle.  
   retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);        
   if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
  
      // Set the version environment attribute.  
      retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER*)SQL_OV_ODBC3, 0);  
      if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
  
         // Allocate the connection handle.  
         retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);  
         if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
            // Call SQLBrowseConnect until it returns a value other than SQL_NEED_DATA   
            // (pass data source name the first time).  If SQL_NEED_DATA is returned, call GetUserInput   
            // (not shown) to build a dialog from the values in szConnStrOut.  The user-supplied values   
            // are returned in szConnStrIn, which is passed in the next call to SQLBrowseConnect.  
  
            strcpy_s((char*)szConnStrIn, _countof(szConnStrIn), "DSN=Sales");  
            do {  
               retcode = SQLBrowseConnect(hdbc, szConnStrIn, SQL_NTS,  
                  szConnStrOut, BRWS_LEN, &cbConnStrOut);  
               if (retcode == SQL_NEED_DATA)  
                  GetUserInput(szConnStrOut, szConnStrIn);  
            } while (retcode == SQL_NEED_DATA);  
  
            if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO){  
  
               // Allocate the statement handle.  
               retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);  
  
               if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO)  
                  // Process data after successful connection  
                  SQLFreeHandle(SQL_HANDLE_STMT, hstmt);  
               SQLDisconnect(hdbc);  
            }  
         }  
         SQLFreeHandle(SQL_HANDLE_DBC, hdbc);  
      }  
   }  
   SQLFreeHandle(SQL_HANDLE_ENV, henv);  
}

추가 정보	참조
연결 핸들 할당	SQLAllocHandle 함수
데이터 소스에 연결	SQLConnect 함수
데이터 원본에서 연결 끊기	SQLDisconnect 함수
연결 문자열 또는 대화 상자를 사용하여 데이터 원본에 연결	SQLDriverConnect 함수
드라이버 설명 및 특성 반환	SQLDrivers 함수
연결 핸들 해제	SQLFreeHandle 함수

참고 항목

ODBC API 참조
ODBC 헤더 파일

다음을 통해 공유

SQLBrowseConnect 함수

구문

인수

반품

진단

InConnectionString 인수

OutConnectionString 인수

SQLBrowseConnect 사용

코드 예

참고 항목

피드백

추가 리소스

다음을 통해 공유

SQLBrowseConnect 함수

구문

인수

반품

진단

InConnectionString 인수

OutConnectionString 인수

SQLBrowseConnect 사용

코드 예

관련 함수

참고 항목

피드백

추가 리소스