CSession – třída

Představuje relaci přístupu k jednoúčelové databázi.

Syntaxe

class CSession

Požadavky

Hlavička: atldbcli.h

Členové

Metody

Název	Popis
Abort	Zruší (ukončí) transakci.
Zavřít	Zavře relaci.
Spáchat	Potvrdí transakci.
GetTransactionInfo	Vrátí informace týkající se transakce.
Otevřená	Otevře novou relaci pro objekt zdroje dat.
StartTransaction	Zahájí novou transakci pro tuto relaci.

Poznámky

Jednu nebo více relací lze přidružit ke každému připojení zprostředkovatele (zdroj dat), který je reprezentován objektem CDataSource . Chcete-li vytvořit novou CSession pro volání CDataSourceCSession::Open. Pro zahájení databázové transakce CSession poskytuje metodu StartTransaction . Jakmile je transakce spuštěna, můžete ji potvrdit pomocí Commit metody nebo ji zrušit pomocí Abort metody.

CSession::Abort

Ukončí transakci.

Syntaxe

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

Parametry

Viz ITransaction::Abort v odkazech programátora OLE DB.

Návratová hodnota

Standardní HODNOTA HRESULT.

CSession::Close

Zavře relaci, kterou otevřel CSession::Open.

Syntaxe

void Close() throw();

Poznámky

m_spOpenRowset Uvolní ukazatel.

CSession::Commit

Potvrdí transakci.

Syntaxe

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

Parametry

Viz ITransaction::Commit v odkazech programátora OLE DB.

Návratová hodnota

Standardní HODNOTA HRESULT.

Poznámky

Další informace naleznete v tématu ITransaction::Commit.

CSession::GetTransactionInfo

Vrátí informace týkající se transakce.

Syntaxe

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

Parametry

Viz ITransaction::GetTransactionInfo v odkazech programátora OLE DB.

Návratová hodnota

Standardní HODNOTA HRESULT.

Poznámky

Další informace naleznete v tématu ITransaction::GetTransactionInfo v odkazech programátora OLE DB.

CSession::Open

Otevře novou relaci pro objekt zdroje dat.

Syntaxe

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

Parametry

Ds
[v] Zdroj dat, pro který se má relace otevřít.

pPropSet
[v] Ukazatel na pole struktur DBPROPSET obsahující vlastnosti a hodnoty, které se mají nastavit. Viz Sady vlastností a skupiny vlastností v odkazech programátorů OLE DB v sadě Windows SDK.

UlPropSets
[v] Počet struktur DBPROPSET předaných v argumentu pPropSet .

Návratová hodnota

Standardní HODNOTA HRESULT.

Poznámky

Před předáním objektu CSession::Openzdroje dat je nutné otevřít objekt zdroje dat pomocí CDataSource::Open.

CSession::StartTransaction

Zahájí novou transakci pro tuto relaci.

Syntaxe

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

Parametry

Viz ITransactionLocal::StartTransaction v odkazech programátora OLE DB.

Návratová hodnota

Standardní HODNOTA HRESULT.

Poznámky

Další informace naleznete v části ITransactionLocal::StartTransaction v odkazech programátora OLE DB.

Viz také

CatDB
Šablony příjemců OLE DB
Referenční dokumentace k šablonám příjemců OLE DB