Oggetti origine dati (OLE DB)

  • Articolo

Si applica a: SQL Server Azure SQL DatabaseIstanza gestita di SQL di AzureAzure Synapse Analytics AnalyticsPlatform System (PDW)

Scaricare il driver OLE DB

OLE DB Driver per SQL Server usa il termine origine dati per il set di interfacce OLE DB usate per stabilire un collegamento a un archivio dati, ad esempio SQL Server. La creazione di un'istanza dell'oggetto di origine dati del provider è la prima attività di un consumer di OLE DB Driver per SQL Server.

Ogni provider OLE DB dichiara un identificatore di classe (CLSID) per se stesso. L'identificatore CLSID per OLE DB Driver per SQL Server è il GUID C/C++ CLSID_MSOLEDBSQL. Il simbolo MSOLEDBSQL_CLSID restituirà il progid corretto nel file msoledbsql.h a cui si fa riferimento. Con il CLSID, il consumer usa la funzione OLE CoCreateInstance per produrre un'istanza dell'oggetto origine dati.

OLE DB Driver per SQL Server è un server in-process. Le istanze degli oggetti del driver OLE DB per SQL Server vengono create usando la macro CLSCTX_INPROC_SERVER per indicare il contesto di esecuzione.

L'oggetto origine dati di OLE DB Driver per SQL Server espone le interfacce di inizializzazione OLE DB che consentono al consumer di connettersi ai database SQL Server esistenti.

Ogni connessione eseguita tramite OLE DB Driver per SQL Server imposta automaticamente queste opzioni:

  • SET ANSI_WARNINGS ON
  • SET ANSI_NULLS ON
  • SET ANSI_PADDING ON
  • SET ANSI_NULL_DFLT_ON ON
  • SET QUOTED_IDENTIFIER ON
  • SET CONCAT_OF_NULL_YIELDS_NULL ON

In questo esempio viene usata la macro dell'identificatore di classe per creare un oggetto origine dati del driver OLE DB per SQL Server e ottenere un riferimento alla relativa interfaccia IDBInitialize.

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

In seguito alla creazione di un'istanza di un oggetto origine dati del driver OLE DB per SQL Server, l'applicazione consumer può proseguire inizializzando l'origine dati e creando le sessioni. Le sessioni OLE DB presentano le interfacce che consentono l'accesso ai dati e la relativa modifica.

OLE DB Driver per SQL Server crea la prima connessione a un'istanza specificata di SQL Server come parte di una corretta inizializzazione dell'origine dati. La connessione viene mantenuta a condizione che venga mantenuto un riferimento in una delle interfacce di inizializzazione dell'origine dati o fino a quando non viene chiamato il metodo IDBInitialize::Uninitialize.

Contenuto della sezione

Vedere anche

Driver OLE DB per programmazione con SQL Server