使用 SQL Server Native Client 標頭檔與程式庫檔案

發行項
2017-03-06

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標頭檔包含利用 2005 SQL Server 2005 中引進的新功能所需的所有定義、屬性、屬性和介面。

除了SQL Server Native Client標頭檔之外，還有 sqlncli11.lib 程式庫檔案，這是 ODBC SQL Server大量複製程式 (BCP) 功能的匯出程式庫。

SQL Server Native Client標頭檔與搭配 Microsoft Data Access Components (MDAC) 使用的 sqloledb.h 和 odbcss.h 標頭檔回溯相容，但不包含 SQLOLEDB 的 CLSID， (MDAC) 隨附 SQL Server的 OLE DB 提供者，或 XML 功能不支援的符號 (SQL Server Native Client) 。

ODBC 應用程式無法在相同程式中參考 sqlncli.h) 和 odbcss.h (SQL Server Native Client標頭。即使您未使用 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標頭檔，您必須在 include C/C++ 程式設計程式碼中使用語句。下列章節描述如何同時針對 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」作為驅動程式名稱字串。

依版本排列的元件名稱和屬性

屬性	SQL Server Native Client SQL Server 2005	SQL Server Native Client 10.0 SQL Server 2008	SQL Server Native Client 11.0 SQL Server 2014	MDAC
ODBC 驅動程式名稱	SQL Native Client	SQL Server Native Client 10.0	SQL Server Native Client 11.0	SQL Server
ODBC 標頭檔名稱	Sqlncli.h	Sqlncli.h	Sqlncli.h	Odbcss.h
ODBC 驅動程式 DLL	Sqlncli.dll	Sqlncl10.dll	Sqlncl11.dll	sqlsrv32.dll
適用於 BCP API 的 ODBC 程式庫檔	Sqlncli.lib	Sqlncli10.lib	Sqlncli11.lib	Odbcbcp.lib
適用於 BCP API 的 ODBC DLL	Sqlncli.dll	Sqlncli10.dll	Sqlncli11.dll	Odbcbcp.dll
OLE DB PROGID	SQLNCLI	SQLNCLI10	SQLNCLI11	SQLOLEDB
OLE DB 標頭檔名稱	Sqlncli.h	Sqlncli.h	Sqlncli.h	Sqloledb.h
OLE DB 提供者 DLL	Sqlncli.dll	Sqlncli10.dll	Sqlncli11.dll	Sqloledb.dll

sqlncli.h 透過 SQLNCLI_VER 宏支援多個版本的 SQL Server Native Client。根據預設，SQLNCLI_VER預設為最新版本的 SQL Server Native Client。若要建立使用 sqlncli10.dll 而非 sqlncli11.dll 的應用程式，請將 SQLNCLI_VER 設定為 10。

靜態連結與 BCP 函數

當應用程式使用 BCP 函數時，應用程式最好在連接字串中指定用來編譯應用程式之標頭檔與程式庫隨附相同版本的驅動程式。

例如，如果您使用 SQL Server Native Client 編譯應用程式，以及從 \Program Files\Microsoft SQL Server\110\SDK 將相關聯的程式庫檔案 (sqlncli11.lib) 和標頭檔 (sqlncli.h) ，請務必在連線中使用 ODBC 指定 (作為) 「DRIVER={SQL Server Native Client 11.0}」的範例字串。

如需詳細資訊，請參閱執行大量複製作業。

另請參閱

使用 SQL Server Native Client 建置應用程式

共用方式為