Oggetti di sessione OLE DB (SQL Server Compact)

La funzione primaria degli oggetti di sessione è definire transazioni, comandi e set di righe e creare e modificare tabelle e indici.

Utilizzo degli oggetti di sessione

In Microsoft SQL Server Compact 3.5 (SQL Server Compact 3.5) è possibile impostare le proprietà di sessione utilizzando l'interfaccia ISessionProperties.

Da una sessione è possibile eseguire le operazioni seguenti:

• Creare un oggetto comando chiamando IDBCreateCommand::CreateCommand. Una sola sessione può supportare più comandi. Per ulteriori informazioni, vedere Comandi OLE DB (SQL Server Compact).
• Creare un set di righe chiamando IOpenRowset::OpenRowset. Per ulteriori informazioni, vedere Set di righe di OLE DB (SQL Server Compact).
• Creare un set di righe dello schema chiamando IDBSchemaRowset::GetRowset. Per ulteriori informazioni sui set di righe dello schema supportati da SQL Server Compact 3.5, vedere Set di righe dello schema OLE DB (SQL Server Compact).
• Creare o modificare tabelle e indici utilizzando ITableDefinition e IIndexDefinition.
• Avviare e concludere transazioni.

Proprietà di sessione specifiche del provider

SQL Server Compact 3.5 supporta la proprietà specifica del provider DBPROP_SSCE_ TRANSACTION_COMMIT_MODE, che viene utilizzata per specificare se il pool di buffer deve essere svuotato dal motore dopo il commit. Per modificare questo valore, passare DBPROP_SSCE_ TRANSACTION_COMMIT_MODE, presente nell'insieme di proprietà DBPROPSET_SSCE_SESSION, all'interfaccia ISessionProperties. Per ulteriori informazioni, vedere Proprietà specifiche del provider (OLE DB).

Nell'esempio seguente viene illustrato come creare un oggetto di sessione e come modificare le proprietà della sessione affinché il pool di buffer venga svuotato dal motore di database dopo il commit.

Esempio

   // Object declarations
HRESULT                  hr=S_OK;
ULONG                    i                    = 0;
DBPROPSET                dbpropset[2];
DBPROP                   dbprop[1];
DBPROP                   sscedbprop[1];

// Declare the provider interfaces.

IDBInitialize *          pIDBInitialize       = NULL;
IDBProperties *          pIDBProperties       = NULL;
IDBCreateSession *       pIDBCreateSession    = NULL;
ISessionProperties *     pISessionProperties  = NULL;
// Initialize the the data source object.
hr = CoCreateInstance(CLSID_SQLSERVERCE, NULL, CLSCTX_INPROC_SERVER, 
        IID_IDBInitialize, (LPVOID *) &pIDBInitialize);
if (FAILED(hr))
{
    //Send an error-specific message and do error handling.
    goto Exit;
}
// Initialize the the property variants.
for (i = 0; i < sizeof(dbprop)/sizeof(dbprop[0]); i++)
{
    VariantInit(&dbprop[i].vValue);
}
for (i = 0; i < sizeof(sscedbprop)/sizeof(sscedbprop[0]); i++)
{
    VariantInit(&sscedbprop[i].vValue);
}
dbprop[0].dwPropertyID   = DBPROP_INIT_DATASOURCE;
dbprop[0].dwOptions = DBPROPOPTIONS_REQUIRED;
dbprop[0].vValue.vt = VT_BSTR;
dbprop[0].vValue.bstrVal = SysAllocString(L"\\windows\\Northwind.sdf");
if(NULL == dbprop[0].vValue.bstrVal)
{
    hr = E_OUTOFMEMORY;
    goto Exit; 
}
dbpropset[0].rgProperties    = dbprop;
dbpropset[0].cProperties     = sizeof(dbprop)/sizeof(dbprop[0]);
dbpropset[0].guidPropertySet = DBPROPSET_DBINIT;
// Initialize the property to change the maximum buffer pool size.
sscedbprop[0].dwPropertyID = DBPROP_SSCE_MAXBUFFERSIZE;
sscedbprop[0].dwOptions = DBPROPOPTIONS_REQUIRED;
sscedbprop[0].vValue.vt = VT_I4;
sscedbprop[0].vValue.lVal = 20*1024; //limit cache usage to 20M, default is 640K
dbpropset[1].rgProperties    = sscedbprop;
dbpropset[1].cProperties     = sizeof(sscedbprop)/sizeof(sscedbprop[0]);
dbpropset[1].guidPropertySet = DBPROPSET_SSCE_DBINIT;
// Set the properties into the provider's data source object.
hr = pIDBInitialize->QueryInterface(IID_IDBProperties,(void**)&pIDBProperties);
if(FAILED(hr))
{
    goto Exit;
}
hr = pIDBProperties->SetProperties(sizeof(dbpropset)/sizeof(dbpropset[0]), 
    dbpropset);
if(FAILED(hr))
{
    goto Exit;
}
// Initialize the data source.
hr = pIDBInitialize->Initialize();
if(FAILED(hr))
{
   goto Exit;
}
// Initialize a session object.
hr = pIDBProperties->QueryInterface(IID_IDBCreateSession, (void **) &pIDBCreateSession);
if (FAILED(hr))
{
    //Send an error-specific message and do error handling.
    goto Exit;
}
hr = pIDBCreateSession->CreateSession(NULL, IID_ISessionProperties, 
    (IUnknown**) &pISessionProperties);
Exit:
    // Clean up resources
    return hr;