CSession クラス

単一のデータベース アクセス セッションを表します。

構文

class CSession

必要条件

ヘッダー: atldbcli.h

メンバー

メソッド

Name	説明
Abort	トランザクションをキャンセル (終了) します。
クローズ	セッションを閉じます。
コミット	トランザクションをコミットします。
GetTransactionInfo	トランザクションに関する情報を返します。
未完了	データ ソース オブジェクトの新しいセッションを開きます。
StartTransaction	このセッションの新しいトランザクションを開始します。

解説

1 つ以上のセッションを、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
[入力] セッションを開く対象のデータ ソース。

pPropSet
[入力] 設定するプロパティと値を含む DBPROPSET 構造体の配列へのポインター。 Windows SDK の "OLE DB プログラマーズ リファレンス" の「プロパティ セットとプロパティ グループ」をご覧ください。

ulPropSets
[入力] 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 コンシューマー テンプレート リファレンス