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。