Klasa CSession
Reprezentuje pojedynczą sesję dostępu do bazy danych.
Składnia
class CSession
Wymagania
Nagłówek: atldbcli.h
Elementy członkowskie
Metody
Nazwa/nazwisko | opis |
---|---|
Abort | Anuluje (kończy) transakcję. |
Zamknij | Zamyka sesję. |
Popełnić | 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ę CDataSource
CSession::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::Open
obiektu ź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