다음을 통해 공유


SQL Server Native Client 헤더 및 라이브러리 파일 사용

SQL Server Native Client 헤더 및 라이브러리 파일은 SQL Server와 함께 설치됩니다. 응용 프로그램을 개발할 때는 개발에 필요한 모든 파일을 사용자의 개발 환경으로 복사하고 설치해야 합니다. SQL Server Native Client를 설치하고 재배포하는 방법은 SQL Server Native Client 설치를 참조하십시오.

SQL Server Native Client 헤더 및 라이브러리 파일은 다음 위치에 설치됩니다.

%PROGRAM FILES%\Microsoft SQL Server\100\SDK

SQL Server Native Client 헤더 파일(sqlncli.h)을 사용하여 SQL Server Native Client 데이터 액세스 기능을 사용자의 사용자 지정 응용 프로그램에 추가할 수 있습니다. SQL Server Native Client 헤더 파일에는 SQL Server 2005에 도입된 새로운 기능을 활용하는 데 필요한 모든 정의, 특성, 속성 및 인터페이스가 포함되어 있습니다.

SQL Server Native Client 헤더 파일 외에도 ODBC의 SQL Server BCP(대량 복사 프로그램) 기능에 사용되는 내보내기 라이브러리인 sqlncli10.lib 라이브러리 파일도 있습니다.

SQL Server Native Client 헤더 파일은 Microsoft Data Access Components(MDAC)에서 사용되는 sqloledb.h 및 odbcss.h 헤더 파일과 호환되지만 SQLOLEDB(MDAC에 포함된 SQL Server용 OLE DB 공급자)에 사용되는 CLSID 또는 XML 기능(SQL Server Native Client에서 지원되지 않음)에 사용되는 기호는 포함하지 않습니다.

여러 개의 ODBC 응용 프로그램이 동일한 프로그램에서 SQL Server Native Client 헤더(sqlncli.h) 및 odbcss.h를 참조할 수 없습니다. SQL Server 2005에 도입된 기능을 전혀 사용하지 않더라도 SQL Server Native Client 헤더 파일이 기존 odbcss.h 대신 사용됩니다.

SQL Server Native Client OLE DB 공급자를 사용하는 OLE DB 응용 프로그램은 sqlncli.h만 참조하면 됩니다. MDAC(SQLOLEDB)와 SQL Server Native Client OLE DB 공급자를 모두 사용하는 응용 프로그램은 sqloledb.h 및 sqlncli.h를 모두 참조할 수 있지만 sqloledb.h를 먼저 참조해야 합니다.

SQL Server Native Client 헤더 파일 사용

SQL Server Native Client 헤더 파일을 사용하려면 사용자의 C/C++ 프로그래밍 코드 내에 include 문을 사용해야 합니다. 다음 섹션에서는 OLE DB 및 ODBC 응용 프로그램에서 이를 수행하는 방법을 설명합니다.

[!참고]

SQL Server Native Client 헤더 및 라이브러리 파일은 Visual Studio C++ 2002 이상을 사용해야 컴파일할 수 있습니다.

OLE DB

OLE DB 응용 프로그램에서 SQL Server Native Client 헤더 파일을 사용하려면 다음 프로그래밍 코드 행을 사용합니다.

#define _SQLNCLI_OLEDB_
include "sqlncli.h";

[!참고]

응용 프로그램에서 OLE DB 및 ODBC API를 모두 사용하는 경우에는 위의 코드에서 첫 번째 행을 생략해야 합니다. 또한 응용 프로그램에 sqloledb.h에 대한 include 문이 있는 경우 sqlncli.h에 대한 include 문이 그 다음에 와야 합니다.

SQL Server Native Client를 통해 데이터 원본에 대한 연결을 만들 때 공급자 이름 문자열에는 "SQLNCLI10"을 사용합니다.

ODBC

ODBC 응용 프로그램에서 SQL Server Native Client 헤더 파일을 사용하려면 다음 프로그래밍 코드 행을 사용합니다.

#define _SQLNCLI_ODBC_
include "sqlncli.h";

[!참고]

응용 프로그램에서 OLE DB 및 ODBC API를 모두 사용하는 경우에는 위의 코드에서 첫 번째 행을 생략해야 합니다. 또한 응용 프로그램에 odbcss.h에 대한 #include 문이 있는 경우 이를 제거해야 합니다.

SQL Server Native Client를 통해 데이터 원본에 대한 연결을 만들 때 드라이버 이름 문자열에는 "SQL Server Native Client 10.0"을 사용합니다.

버전별 구성 요소 이름 및 속성

속성

SQL Server Native Client

SQL Server 2005

SQL Server Native Client 10.0

SQL Server 2008

MDAC

ODBC 드라이버 이름

SQL Native Client

SQL Server Native Client 10.0

SQL Server

ODBC 헤더 파일 이름

Sqlncli.h

Sqlncli.h

Odbcss.h

ODBC 드라이버 DLL

Sqlncli.dll

Sqlncl10.dll

sqlsrv32.dll

BCP API용 ODBC 라이브러리 파일

Sqlncli.lib

Sqlncli10.lib

Odbcbcp.lib

BCP API용 ODBC DLL

Sqlncli.dll

Sqlncli10.dll

Odbcbcp.dll

OLE DB PROGID

SQLNCLI

SQLNCLI10

SQLOLEDB

OLE DB 헤더 파일 이름

Sqlncli.h

Sqlncli.h

Sqloledb.h

OLE DB 공급자 DLL

Sqlncli.dll

Sqlncli10.dll

Sqloledb.dll

sqlncli.h는 SQLNCLI_VER 매크로를 통해 여러 버전의 SQL Server Native Client를 지원합니다. 기본적으로 SQLNCLI_VER의 기본값은 최신 버전의 SQL Server Native Client입니다. sqlncli10.dll 대신 sqlncli.dll을 사용하는 응용 프로그램을 작성하려면 SQLNCLI_VER를 90으로 설정합니다.

정적 연결 및 BCP 함수

응용 프로그램에서 BCP 함수를 사용하는 경우 응용 프로그램의 연결 문자열에 응용 프로그램을 컴파일하는 데 사용된 헤더 파일 및 라이브러리가 함께 제공되는 동일한 버전의 드라이버를 지정해야 합니다.

예를 들어, SQL Server 2008 Native Client와 \Program Files\Microsoft SQL Server\100\SDK의 연관된 라이브러리 파일(sqlncli10.lib) 및 헤더 파일(sqlncli.h)을 사용하여 응용 프로그램을 컴파일하는 경우 연결 문자열에 "DRIVER={SQL Server Native Client 10.0}"을 지정해야 합니다(예로 ODBC 사용).

자세한 내용은 대량 복사 작업 수행 수행을 참조하십시오.

변경 내역

업데이트된 내용

BCP 함수 및 정적 연결에 대한 섹션을 추가했습니다.