다음을 통해 공유


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에 의해 반환되는 확장 문자열의 예는 다음과 같습니다.

ServerName\InstanceName;Clustered:No;Version:8.00.131

이 문자열에서 세미콜론은 서버에 대한 다양한 정보 부분을 구분합니다. 서로 다른 서버 인스턴스를 구분하려면 쉼표를 사용합니다.

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(서비스 사용자 이름)을 참조하십시오.

참고 항목

개념

관련 자료