Klasa CSession

Reprezentuje pojedynczą sesję dostępu do bazy danych.

Składnia

class CSession

Wymagania

Nagłówek: atldbcli.h

Członkowie

Metody

Nazwa/nazwisko	opis
Abort	Anuluje (kończy) transakcję.
Zamknij	Zamyka sesję.
Zatwierdzanie	Zatwierdza transakcję.
GetTransactionInfo	Zwraca informacje dotyczące transakcji.
Otwórz	Otwiera nową sesję dla obiektu źródła danych.
StartTransaction	Rozpoczyna nową transakcję dla tej sesji.

Uwagi

Co najmniej jedna sesja może być skojarzona z każdym połączeniem dostawcy (źródłem danych), które jest reprezentowane przez obiekt CDataSource . Aby utworzyć nowy CSession element dla elementu , wywołaj metodę CDataSourceCSession::Open. Aby rozpocząć transakcję bazy danych, CSession udostępnia metodę StartTransaction . Po rozpoczęciu transakcji można ją zatwierdzić przy użyciu Commit metody lub anulować przy użyciu Abort metody .

CSession::Abort

Kończy transakcję.

Składnia

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

Parametry

Zobacz ITransaction::Abort w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

CSession::Close

Zamyka sesję, która została otwarta przez CSession::Open.

Składnia

void Close() throw();

Uwagi

m_spOpenRowset Zwalnia wskaźnik.

CSession::Commit

Zatwierdza transakcję.

Składnia

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

Parametry

Zobacz ITransaction::Commit w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

Uwagi

Aby uzyskać więcej informacji, zobacz ITransaction::Commit.

CSession::GetTransactionInfo

Zwraca informacje dotyczące transakcji.

Składnia

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

Parametry

Zobacz ITransaction::GetTransactionInfo w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

Uwagi

Aby uzyskać więcej informacji, zobacz ITransaction::GetTransactionInfo w dokumentacji programisty OLE DB.

CSession::Open

Otwiera nową sesję dla obiektu źródła danych.

Składnia

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

Parametry

Ds
[in] Źródło danych, dla którego ma zostać otwarta sesja.

pPropSet
[in] Wskaźnik do tablicy struktur DBPROPSET zawierających właściwości i wartości do ustawienia. Zobacz Zestawy właściwości i grupy właściwości w dokumentacji programisty OLE DB w zestawie Windows SDK.

ulPropSets
[in] Liczba struktur DBPROPSET przekazanych w argumencie pPropSet .

Wartość zwracana

Standardowy HRESULT.

Uwagi

Przed przekazaniem obiektu do CSession::Openobiektu źródła danych należy otworzyć obiekt CDataSource::Open.

CSession::StartTransaction

Rozpoczyna nową transakcję dla tej sesji.

Składnia

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

Parametry

Zobacz ITransactionLocal::StartTransaction w dokumentacji programisty OLE DB.

Wartość zwracana

Standardowy HRESULT.

Uwagi

Aby uzyskać więcej informacji, zobacz ITransactionLocal::StartTransaction w dokumentacji programisty OLE DB.

Zobacz też

CatDB
Szablony konsumentów OLE DB
Szablony konsumentów OLE DB — dokumentacja