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。