共用方式為


CSession 類別

表示單一數據庫存取會話。

語法

class CSession

需求

標頭檔:atldbcli.h

成員

方法

名稱 描述
Abort 取消交易(終止)。
關閉 關閉工作階段。
認可 認可交易。
GetTransactionInfo 傳回交易的相關信息。
Open 開啟數據源物件的新會話。
StartTransaction 開始此會話的新交易。

備註

一或多個會話可以與 CDataSource 物件表示的每個提供者連接 (資料源) 相關聯。 若要為 CDataSource建立新的 CSession ,請呼叫 CSession::Open。 若要開始資料庫交易, CSession 請提供 StartTransaction 方法。 交易啟動后,您可以使用 方法認可它 Commit ,或使用 方法取消它 Abort

CSession::Abort

終止交易。

語法

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

參數

請參閱 OLE DB 程式設計人員參考中的 ITransaction::Abort

傳回值

標準 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();

參數

請參閱 OLE DB 程式設計人員參考中的 ITransaction::Commit

傳回值

標準 HRESULT。

備註

如需詳細資訊,請參閱 ITransaction::Commit

CSession::GetTransactionInfo

傳回交易的相關信息。

語法

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

參數

請參閱 OLE DB 程式設計人員參考中的 ITransaction::GetTransactionInfo

傳回值

標準 HRESULT。

備註

如需詳細資訊,請參閱 OLE DB 程式設計人員參考中的 ITransaction::GetTransactionInfo

CSession::Open

開啟數據源物件的新會話。

語法

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

參數

ds
[in]要開啟會話的數據源。

pPropSet
[in]DBPROPSET 結構的陣列指標,其中包含要設定的屬性和值。 請參閱 Windows SDK 中 OLE DB 程式設計人員參考中的屬性集和屬性群組

ulPropSets
[in]在 pPropSet 自變數中傳遞的 DBPROPSET 結構數目。

傳回值

標準 HRESULT。

備註

您必須先使用 CDataSource::Open 開啟資料來源物件,才能將它傳遞至 CSession::Open

CSession::StartTransaction

開始此會話的新交易。

語法

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

參數

請參閱 OLE DB 程式設計人員參考中的 ITransactionLocal::StartTransaction

傳回值

標準 HRESULT。

備註

如需詳細資訊,請參閱 OLE DB 程式設計人員參考中的 ITransactionLocal::StartTransaction

另請參閱

CatDB
OLE DB 消費者範本
OLE DB 消費者範本參考