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\110\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(대량 복사 프로그램) 기능에 사용되는 내보내기 라이브러리인 sqlncli11.lib 라이브러리 파일도 있습니다.

SQL Server Native Client 헤더 파일은 Microsoft Data Access Components(MDAC)에서 사용되는 sqloledb.h 및 odbcss.h 헤더 파일과 호환되지만 SQLOLEDB(MDAC에 포함된 SQL Server용 OLE DB Provider)에 사용되는 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 Provider를 사용하는 OLE DB 응용 프로그램은 sqlncli.h만 참조하면 됩니다. MDAC(SQLOLEDB)와 SQL Server Native Client OLE DB Provider를 모두 사용하는 응용 프로그램은 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를 통해 데이터 원본에 대한 연결을 만들 때 공급자 이름 문자열에는 "SQLNCLI11"을 사용합니다.

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 11.0"을 사용합니다.

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

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

정적 연결 및 BCP 함수

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

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

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

참고 항목

관련 자료

SQL Server Native Client를 사용하여 응용 프로그램 빌드