CSession-Klasse

Stellt eine einzelne Datenbankzugriffssitzung dar.

Syntax

class CSession

Requirements (Anforderungen)

Header: atldbcli.h

Mitglieder

Methoden

Name	Beschreibung
Abort	Bricht die Transaktion ab (beendet).
Schließen	Schließt die Sitzung.
Commit	Führt einen Commit für die Transaktion durch.
GetTransactionInfo	Gibt Informationen zu einer Transaktion zurück.
Öffnen	Öffnet eine neue Sitzung für das Datenquellenobjekt.
Starttransaction	Beginnt eine neue Transaktion für diese Sitzung.

Hinweise

Mindestens eine Sitzung kann jeder Anbieterverbindung (Datenquelle) zugeordnet werden, die durch ein CDataSource-Objekt dargestellt wird. Rufen Sie CSession::Open auf, um ein neues CSession für ein CDataSource, rufen Sie CSession::Open auf. Zum Starten einer Datenbanktransaktion CSession stellt die Methode bereit StartTransaction . Nachdem eine Transaktion gestartet wurde, können Sie ihn mithilfe der Commit Methode übernehmen oder mit der Abort Methode abbrechen.

CSession::Abort

Beendet die Transaktion.

Syntax

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

Parameter

Siehe "ITransaction::Abort " in der OLE DB-Programmierreferenz.

Rückgabewert

Ein Standard-HRESULT.

CSession::Close

Schließt die Sitzung, die von CSession::Open geöffnet wurde.

Syntax

void Close() throw();

Hinweise

Gibt den m_spOpenRowset Mauszeiger frei.

CSession::Commit

Führt einen Commit für die Transaktion durch.

Syntax

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

Parameter

Siehe "ITransaction::Commit " in der OLE DB-Programmierreferenz.

Rückgabewert

Ein Standard-HRESULT.

Hinweise

Weitere Informationen finden Sie unter "ITransaction::Commit".

CSession::GetTransactionInfo

Gibt Informationen zu einer Transaktion zurück.

Syntax

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

Parameter

Siehe "ITransaction::GetTransactionInfo " in der OLE DB-Programmierreferenz.

Rückgabewert

Ein Standard-HRESULT.

Hinweise

Weitere Informationen finden Sie unter "ITransaction::GetTransactionInfo " in der OLE DB-Programmierreferenz.

CSession::Open

Öffnet eine neue Sitzung für das Datenquellenobjekt.

Syntax

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

Parameter

Ds
[in] Die Datenquelle, für die die Sitzung geöffnet werden soll.

pPropSet
[in] Ein Zeiger auf ein Array von DBPROPSET-Strukturen , die Eigenschaften und Werte enthalten, die festgelegt werden sollen. Siehe Eigenschaftensätze und Eigenschaftengruppen in der OLE DB-Programmierreferenz im Windows SDK.

ulPropSets
[in] Die Anzahl der im pPropSet-Argument übergebenen DBPROPSET-Strukturen.

Rückgabewert

Ein Standard-HRESULT.

Hinweise

Sie müssen das Datenquellenobjekt mit CDataSource::Open öffnen, bevor Sie es an CSession::Open.

CSession::StartTransaction

Beginnt eine neue Transaktion für diese Sitzung.

Syntax

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

Parameter

Siehe ITransactionLocal::StartTransaction in der OLE DB-Programmierreferenz.

Rückgabewert

Ein Standard-HRESULT.

Hinweise

Weitere Informationen finden Sie unter "ITransactionLocal::StartTransaction " in der OLE DB-Programmierreferenz.

Siehe auch

CatDB
OLE DB-Consumervorlagen
Referenz der OLE DB-Consumervorlagen