SQLBrowseConnect
SQLBrowseConnect는 세 수준의 연결 정보로 분류될 수 있는 키워드를 사용합니다. 다음 표에서는 각 키워드에 대해 유효한 값 목록의 반환 여부와 키워드가 선택 사항인지 여부를 보여 줍니다.
수준 1
키워드 |
목록 반환 여부 |
선택 사항 여부 |
설명 |
---|---|---|---|
DSN |
N/A |
아니요 |
SQLDataSources에서 반환되는 데이터 원본의 이름입니다. DRIVER 키워드가 사용되는 경우에는 DSN 키워드를 사용할 수 없습니다. |
DRIVER |
N/A |
아니요 |
Microsoft_ SQL Server Native Client ODBC 드라이버 이름은 {SQL Server Native Client 10}입니다. DSN 키워드가 사용되는 경우에는 DRIVER 키워드를 사용할 수 없습니다. |
수준 2
키워드 |
목록 반환 여부 |
선택 사항 여부 |
설명 |
---|---|---|---|
SERVER |
예 |
아니요 |
데이터 원본이 있는 네트워크의 서버 이름입니다. "(로컬)"이란 용어를 서버로 입력할 수 있으며, 이 경우 네트워크로 연결되지 않은 버전인 경우에도 SQL Server의 로컬 복사본을 사용할 수 있습니다. |
UID |
아니요 |
예 |
사용자 로그인 ID입니다. |
PWD |
아니요 |
예(사용자에 따라 달라짐) |
사용자가 지정한 암호입니다. |
APP |
아니요 |
예 |
SQLBrowseConnect를 호출하는 응용 프로그램 이름입니다. |
WSID |
아니요 |
예 |
워크스테이션 ID입니다. 일반적으로 응용 프로그램이 실행되는 컴퓨터의 네트워크 이름입니다. |
수준 3
키워드 |
목록 반환 여부 |
선택 사항 여부 |
설명 |
---|---|---|---|
DATABASE |
예 |
예 |
SQL Server 데이터베이스의 이름입니다. |
LANGUAGE |
예 |
예 |
SQL Server에서 사용하는 국가별 언어입니다. |
SQLBrowseConnect는 ODBC 데이터 원본 정의에 저장된 LANGUAGE 키워드와 DATABASE 값을 무시합니다. SQLBrowseConnect에 전달되는 연결 문자열에 지정된 데이터베이스 또는 언어가 잘못된 경우 SQLBrowseConnect에서 SQL_NEED_DATA 및 수준 3 연결 특성을 반환합니다.
SQLSetConnectAttr을 호출하여 설정되는 다음 특성은 SQLBrowseConnect에서 반환되는 결과 집합을 결정합니다.
특성 |
설명 |
---|---|
SQL_COPT_SS_BROWSE_CONNECT |
SQL Server 2000 이상 버전에서 SQL_MORE_INFO_YES로 설정된 경우 SQLBrowseConnect는 서버 속성의 확장 문자열을 반환합니다. SQL Server 2000에서 SQLBrowseConnect에 의해 반환되는 확장 문자열의 예는 다음과 같습니다.
이 문자열에서 세미콜론은 서버에 대한 다양한 정보 부분을 구분합니다. 서로 다른 서버 인스턴스를 구분하려면 쉼표를 사용합니다. |
SQL_COPT_SS_BROWSE_SERVER |
서버 이름이 지정된 경우 SQLBrowseConnect는 지정된 서버에 대한 정보를 반환합니다. SQL_COPT_SS_BROWSE_SERVER가 NULL로 설정된 경우 SQLBrowseConnect는 도메인의 모든 서버에 대한 정보를 반환합니다.
참고
네트워크 문제로 인해 SQLBrowseConnect는 모든 서버로부터 시기 적절한 응답을 받지 못할 수 있습니다. 그러므로 반환되는 서버 목록은 각 요청이 있을 때마다 다를 수 있습니다.
|
SQL_COPT_SS_BROWSE_CACHE_DATA |
SQL_COPT_SS_BROWSE_CACHE_DATA 특성이 SQL_CACHE_DATA_YES로 설정되었을 때 버퍼 길이가 결과를 저장하기에 부족한 경우 데이터를 청크로 인출할 수 있습니다. 버퍼 길이는 SQLBrowseConnect.에 대한 BufferLength 인수에 지정되어 있습니다. 더 많은 데이터를 사용할 수 있을 때 SQL_NEED_DATA가 반환됩니다. 검색할 데이터가 더 없는 경우 SQL_SUCCESS가 반환됩니다. 기본값은 SQL_CACHE_DATA_NO입니다. |
SPN(서비스 사용자 이름)에 대한 SQLBrowseConnect 지원
연결이 열릴 때 SQL Server Native Client는 SQL_COPT_SS_MUTUALLY_AUTHENTICATED 및 SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD를 연결을 여는 데 사용하는 인증 방법으로 설정합니다.
SPN에 대한 자세한 내용은 클라이언트 연결(ODBC)의 SPN(서비스 사용자 이름)을 참조하십시오.