Объекты сеанса OLE DB (SQL Server Compact)

Основная функция объекта сеанса — определение транзакций, команд и наборов строк, а также создание и изменение таблиц и индексов.

Использование объектов сеанса

В MicrosoftSQL Server Compact 4.0 свойства сеанса можно настроить с помощью интерфейса ISessionProperties.

В сеансе можно выполнить следующие действия.

• Создать объект команды путем вызова функции IDBCreateCommand::CreateCommand. Один сеанс поддерживает несколько команд. Дополнительные сведения см. в разделе Команды OLE DB (SQL Server Compact).

• Создать набор строк путем вызова функции IOpenRowset::OpenRowset. Дополнительные сведения см. в разделе Наборы строк OLE DB (SQL Server Compact).

• Создать набор строк схемы путем вызова функции IDBSchemaRowset::GetRowset. Дополнительные сведения о наборах строк схемы, поддерживаемых SQL Server Compact 4.0, см. в разделе Наборы строк схемы OLE DB (SQL Server Compact).

• Создавать или изменять таблицы или индексы с помощью ITableDefinition и IIndexDefinition.

• Запускать и завершать транзакции.

Специфические для поставщика свойства сеанса

SQL Server Compact 4.0 поддерживает специфическое для поставщика свойство DBPROP_SSCE_TRANSACTION_COMMIT_MODE. Это свойство служит для указания, должно ли ядро СУБД сбрасывать пул буферов после фиксации. Чтобы изменить это значение, передайте DBPROP_SSCE_TRANSACTION_COMMIT_MODE в наборе свойств DBPROPSET_SSCE_SESSION в интерфейс ISessionProperties. Дополнительные сведения см. в разделе Специфические для поставщика свойства (OLE DB).

В приведенном примере показан способ создания объекта сеанса и изменения свойств сеанса таким образом, чтобы ядро СУБД сбрасывало пул буферов после фиксации.

Пример

   // 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;