Udostępnij za pomocą


Obiekty Źródła Danych (OLE DB)

Dotyczy do:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSystem Platform Analitycznych (PDW)Baza danych SQL w Microsoft Fabric

pobierz sterownik OLE DB

OLE DB Driver for SQL Server używa terminu źródło danych dla zestawu interfejsów OLE DB służących do nawiązania łącza z magazynem danych, takim jak SQL Server. Utworzenie instancji obiektu źródłowego danych dostawcy jest pierwszym zadaniem konsumenta sterownika OLE DB dla SQL Server.

Każdy dostawca OLE DB deklaruje dla siebie identyfikator klasy (CLSID). CLSID sterownika OLE DB dla SQL Server to CLSID_MSOLEDBSQL GUID C/C++ (symbol MSOLEDBSQL_CLSID rozwiąże się na poprawny progid w pliku msoledbsql.h, do którego się odwołujesz). W przypadku CLSID użytkownik używa funkcji OLE CoCreateInstance do wytworzenia instancji obiektu źródła danych.

OLE DB Driver for SQL Server to serwer w trakcie procesu. Instancje sterownika OLE DB dla obiektów SQL Server są tworzone za pomocą makra CLSCTX_INPROC_SERVER, aby wskazać kontekst wykonywalny.

Sterownik OLE DB dla obiektu źródła danych SQL Server udostępnia interfejsy inicjalizacyjne OLE DB, które pozwalają użytkownikowi łączyć się z istniejącymi bazami danych SQL Server.

Każde połączenie nawiązane przez sterownik OLE DB dla SQL Server automatycznie ustawia następujące opcje:

  • USTAW ANSI_WARNINGS NA
  • USTAW ANSI_NULLS NA
  • USTAW ANSI_PADDING NA
  • USTAW ANSI_NULL_DFLT_ON NA
  • USTAW QUOTED_IDENTIFIER NA
  • USTAW CONCAT_OF_NULL_YIELDS_NULL NA

Ten przykład wykorzystuje makro identyfikatora klasy do utworzenia sterownika OLE DB dla obiektu źródła danych SQL Server i uzyskania odniesienia do jego IDBInitialize interfejsu.

IDBInitialize*   pIDBInitialize;
HRESULT          hr;

hr = CoCreateInstance(CLSID_MSOLEDBSQL, 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.
}

Po pomyślnym utworzeniu instancji sterownika OLE DB dla obiektu źródła SQL Server, aplikacja konsumencka może kontynuować proces inicjalizacji źródła danych i tworzenia sesji. Sesje OLE DB prezentują interfejsy umożliwiające dostęp do danych i ich manipulację.

Sterownik OLE DB dla SQL Server nawiązuje pierwsze połączenie z określoną instancją SQL Server w ramach pomyślnej inicjalizacji źródła danych. Połączenie jest utrzymywane tak długo, jak referencja jest utrzymwana na dowolnym interfejsie inicjalizacyjnym źródła danych lub do momentu wywołania metody IDBInitialize::Uninitialize .

W tej Sekcji

Zobacz też

sterownik OLE DB dla programowania programu SQL Server