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