SQL Server Yerel İstemci Veri Kaynak Nesneleri (OLE DB)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnalytics Platform System (PDW)

Important

SQL Server Native Client (genellikle kısaltılmış SNAC) SQL Server 2022 (16.x) ve SQL Server Management Studio 19'dan (SSMS) kaldırılmıştır. Hem SQL Server Yerel İstemci OLE DB sağlayıcısı (SQLNCLI veya SQLNCLI11) hem de SQL Server için eski Microsoft OLE DB Sağlayıcısı (SQLOLEDB) yeni geliştirme için önerilmez. İleride SQL Server için yeni Microsoft OLE DB Sürücüsüne (MSOLEDBSQL) geçin.

SQL Server Native Client, SQL Server gibi bir veri deposuna bağlantı kurmak için kullanılan OLE DB arayüzleri seti için veri kaynağı terimini kullanır. Sağlayıcının veri kaynak nesnesinin bir örneğini oluşturmak, SQL Server Native Client tüketicisinin ilk görevidir.

Her OLE DB sağlayıcısı kendisi için bir sınıf tanımlayıcısı (CLSID) ilan eder. SQL Server Native Client OLE DB sağlayıcısının CLSID'i C/C++ GUID CLSID_SQLNCLI10'dir (sembol, referans verdiğiniz sqlncli.h dosyasında doğru progid'e çözüm SQLNCLI_CLSID). CLSID ile tüketici, veri kaynağı nesnesinin bir örneğini üretmek için OLE CoCreateInstance fonksiyonunu kullanır.

SQL Server Native Client işlemde olan bir sunucudur. Yerel SQL Server İstemci OLE DB sağlayıcı nesnelerinin örnekleri, çalıştırılabilir bağlamı belirtmek için CLSCTX_INPROC_SERVER makrosu kullanılarak oluşturulur.

SQL Server Native Client OLE DB sağlayıcı veri kaynağı nesnesi, tüketicinin mevcut SQL Server veritabanlarına bağlanmasını sağlayan OLE DB başlatma arayüzlerini ortaya çıkarır.

SQL Server Native Client OLE DB sağlayıcısı aracılığıyla yapılan her bağlantı bu seçenekleri otomatik olarak ayarlar:

  • SET ANSI_WARNINGS AÇIK

  • SET ANSI_NULLS AÇIK

  • SET ANSI_PADDING AÇIK

  • SET ANSI_NULL_DFLT_ON AÇIK

  • SET QUOTED_IDENTIFIER AÇIK

  • SET CONCAT_OF_NULL_YIELDS_NULL DEVAM ET

Bu örnek, SQL Server Native Client OLE DB sağlayıcı veri kaynağı nesnesi oluşturmak ve IDBInitialize arayüzüne referans almak için sınıf tanımlayıcı makrosunu kullanır.

IDBInitialize*   pIDBInitialize;  
HRESULT          hr;  
  
hr = CoCreateInstance(CLSID_SQLNCLI10, NULL, CLSCTX_INPROC_SERVER,  
    IID_IDBInitialize, (void**) &pIDBInitialize);  
  
if (SUCCEEDED(hr))  
{  
    //  Perform necessary processing with the interface.  
    pIDBInitialize->Uninitialize();  
    pIDBInitialize->Release();  
}  
else  
{  
    // Display error from CoCreateInstance.  
}  

SQL Server Native Client OLE DB sağlayıcı veri kaynak nesnesinin başarılı bir örneği oluşturulduğunda, tüketici uygulaması veri kaynağını başlatarak ve oturumlar oluşturarak devam edebilir. OLE DB oturumları, veri erişimi ve manipülasyonuna olanak tanıyan arayüzleri sunar.

SQL Server Native Client OLE DB sağlayıcısı, başarılı bir veri kaynağı başlatmanın parçası olarak belirli bir SQL Server örneğine ilk bağlantısını yapar. Bağlantı, herhangi bir veri kaynağı başlatma arayüzünde bir referans tutulduğu sürece veya IDBInitialize::Uninitialize yöntemi çağrılana kadar korunur.

Bu Kısımda

Ayrıca Bkz.

SQL Server Yerel İstemcisi (OLE DB)