Поделиться через

класс CSession

  • Статья

Представляет один сеанс доступа к базе данных.

Синтаксис

class CSession

Требования

Заголовок: atldbcli.h

Участники

Методы

Имя Описание
Abort Отменяет (завершает) транзакцию.
Закрыть Закрывает сеанс.
Фиксация Завершает транзакцию.
GetTransactionInfo Возвращает сведения о транзакции.
Открыть Открывает новый сеанс для объекта источника данных.
StartTransaction Начинает новую транзакцию для этого сеанса.

Замечания

Один или несколько сеансов можно связать с каждым подключением поставщика (источником данных), который представлен объектом CDataSource . Чтобы создать новый CSession объект, CDataSourceвызовите CSession::Open. Чтобы начать транзакцию базы данных, CSession предоставляет StartTransaction метод. После запуска транзакции его можно зафиксировать с помощью Commit метода или отменить его с помощью Abort метода.

CSession::Abort

Завершает транзакцию.

Синтаксис

HRESULT Abort(BOID* pboidReason = NULL,
   BOOL bRetaining = FALSE,
   BOOL bAsync = FALSE) const throw();

Параметры

См. раздел ITransaction::Abort в справочнике программиста OLE DB.

Возвращаемое значение

Стандартный HRESULT.

CSession::Close

Закрывает сеанс, который был открыт CSession::Open.

Синтаксис

void Close() throw();

Замечания

m_spOpenRowset Освобождает указатель.

CSession::Commit

Завершает транзакцию.

Синтаксис

HRESULT Commit(BOOL bRetaining = FALSE,
   DWORD grfTC = XACTTC_SYNC,
   DWORD grfRM = 0) const throw();

Параметры

См. раздел ITransaction::Commit в справочнике программиста OLE DB.

Возвращаемое значение

Стандартный HRESULT.

Замечания

Дополнительные сведения см. в разделе ITransaction::Commit.

CSession::GetTransactionInfo

Возвращает сведения о транзакции.

Синтаксис

HRESULT GetTransactionInfo(XACTTRANSINFO* pInfo) const throw();

Параметры

См. раздел ITransaction::GetTransactionInfo в справочнике программиста OLE DB.

Возвращаемое значение

Стандартный HRESULT.

Замечания

Дополнительные сведения см. в разделе ITransaction::GetTransactionInfo в справочнике программиста OLE DB.

CSession::Open

Открывает новый сеанс для объекта источника данных.

Синтаксис

HRESULT Open(const CDataSource& ds,
   DBPROPSET *pPropSet = NULL,
   ULONG ulPropSets = 0) throw();

Параметры

ds
[in] Источник данных, для которого должен быть открыт сеанс.

pPropSet
[in] Указатель на массив структур DBPROPSET , содержащих свойства и значения, которые необходимо задать. См . раздел "Наборы свойств" и "Группы свойств" в справочнике программиста OLE DB в пакете SDK для Windows.

ulPropSets
[in] Число структур DBPROPSET, переданных в аргументе pPropSet.

Возвращаемое значение

Стандартный HRESULT.

Замечания

Перед передачей CSession::Openобъекта источника данных необходимо открыть объект источника данных с помощью CDataSource::Open.

CSession::StartTransaction

Начинает новую транзакцию для этого сеанса.

Синтаксис

HRESULT StartTransaction(ISOLEVEL isoLevel = ISOLATIONLEVEL_READCOMMITTED,
   ULONG isoFlags = 0,
   ITransactionOptions* pOtherOptions = NULL,
   ULONG* pulTransactionLevel = NULL) const throw();

Параметры

См. статью ITransactionLocal::StartTransaction в справочнике программиста OLE DB.

Возвращаемое значение

Стандартный HRESULT.

Замечания

Дополнительные сведения см. в разделе ITransactionLocal::StartTransaction в справочнике программиста OLE DB.

См. также

CatDB
Шаблоны объекта-получателя OLE DB
Ссылка на шаблоны объекта-получателя OLE DB