Dela via

Datakällobjekt (OLE DB)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalysplattformssystem (PDW)SQL-databas i Microsoft Fabric

Ladda ned OLE DB-drivrutins

OLE DB Driver för SQL Server använder termen datakälla för uppsättningen av OLE DB-gränssnitt som används för att etablera en länk till ett datalager, såsom SQL Server. Att skapa en instans av leverantörens datakällobjekt är den första uppgiften för en OLE DB-drivrutin för SQL Server-konsumenter.

Varje OLE DB-leverantör deklarerar en klassidentifierare (CLSID) för sig själv. CLSID:n för OLE DB-drivrutinen för SQL Server är C/C++ GUID CLSID_MSOLEDBSQL (symbolen MSOLEDBSQL_CLSID kommer att upplösas till rätt progid i filen msoledbsql.h som du refererar till). Med CLSID använder konsumenten OLE-funktionen CoCreateInstance för att tillverka en instans av datakällobjektet.

OLE DB-drivrutinen för SQL Server är en server under processen. Instanser av OLE DB Driver för SQL Server-objekt skapas med hjälp av makro CLSCTX_INPROC_SERVER för att ange den exekverbara kontexten.

OLE DB-drivrutinen för SQL Server-datakällobjektet exponerar OLE DB-initialiseringsgränssnitt som tillåter konsumenten att ansluta till befintliga SQL Server-databaser.

Varje anslutning som görs via OLE DB-drivrutinen för SQL Server sätter automatiskt dessa alternativ:

  • SÄTT ANSI_WARNINGS
  • SÄTT ANSI_NULLS PÅ
  • SÄTT ANSI_PADDING PÅ
  • SÄTT ANSI_NULL_DFLT_ON PÅ
  • SÄTT QUOTED_IDENTIFIER PÅ
  • SÄTT CONCAT_OF_NULL_YIELDS_NULL PÅ

Detta exempel använder klassidentifierarmakrot för att skapa en OLE DB-drivrutin för SQL Server-datakällobjektet och få en referens till dess IDBInitialize gränssnitt.

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.
}

Med lyckad skapande av en instans av en OLE DB-drivrutin för SQL Server-datakällobjekt kan konsumentapplikationen fortsätta genom att initiera datakällan och skapa sessioner. OLE DB-sessioner presenterar gränssnitt som möjliggör dataåtkomst och manipulation.

OLE DB-drivrutinen för SQL Server gör sin första anslutning till en specificerad instans av SQL Server som en del av en lyckad initialisering av datakällan. Anslutningen upprätthålls så länge en referens upprätthålls på något initialiseringsgränssnitt för datakällan, eller tills IDBInitialize::Uninitialize metoden anropas.

I det här avsnittet

Se även

OLE DB-drivrutin för SQL Server Programming

  • Last updated on