Condividi tramite

Classe CSession

  • Articolo

Rappresenta una singola sessione di accesso al database.

Sintassi

class CSession

Requisiti

Intestazione: atldbcli.h

Membri

Metodi

Nome Descrizione
Abort Annulla (termina) la transazione.
Chiudi Chiude la sessione.
Eseguire il commit Esegue il commit della transazione.
GetTransactionInfo Restituisce informazioni relative a una transazione.
Si apra Apre una nuova sessione per l'oggetto origine dati.
StartTransaction Avvia una nuova transazione per questa sessione.

Osservazioni:

Una o più sessioni possono essere associate a ogni connessione del provider (origine dati), rappresentata da un oggetto CDataSource . Per creare un nuovo CSession oggetto per , CDataSourcechiamare CSession::Open. Per avviare una transazione di database, CSession fornisce il StartTransaction metodo . Dopo l'avvio di una transazione, è possibile eseguirne il commit usando il Commit metodo o annullarlo usando il Abort metodo .

CSession::Abort

Termina la transazione.

Sintassi

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

Parametri

Vedere ITransaction::Abort nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

CSession::Close

Chiude la sessione, aperta da CSession::Open.

Sintassi

void Close() throw();

Osservazioni:

Rilascia il m_spOpenRowset puntatore.

CSession::Commit

Esegue il commit della transazione.

Sintassi

HRESULT Commit(BOOL bRetaining = FALSE,
   DWORD grfTC = XACTTC_SYNC,
   DWORD grfRM = 0) const throw();

Parametri

Vedere ITransaction::Commit nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

Osservazioni:

Per altre informazioni, vedere ITransaction::Commit.

CSession::GetTransactionInfo

Restituisce informazioni relative a una transazione.

Sintassi

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

Parametri

Vedere ITransaction::GetTransactionInfo nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

Osservazioni:

Per altre informazioni, vedere ITransaction::GetTransactionInfo nella guida di riferimento per programmatori OLE DB.

CSession::Open

Apre una nuova sessione per l'oggetto origine dati.

Sintassi

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

Parametri

Ds
[in] Origine dati per cui aprire la sessione.

pPropSet
[in] Puntatore a una matrice di strutture DBPROPSET contenenti proprietà e valori da impostare. Vedere Set di proprietà e gruppi di proprietà nella guida di riferimento per programmatori OLE DB in Windows SDK.

ulPropSets
[in] Numero di strutture DBPROPSET passate nell'argomento pPropSet .

Valore restituito

HRESULT standard.

Osservazioni:

È necessario aprire l'oggetto origine dati usando CDataSource::Open prima di passarlo a CSession::Open.

CSession::StartTransaction

Avvia una nuova transazione per questa sessione.

Sintassi

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

Parametri

Vedere ITransactionLocal::StartTransaction nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

Osservazioni:

Per altre informazioni, vedere ITransactionLocal::StartTransaction nella guida di riferimento per programmatori OLE DB.

Vedi anche

CatDB
Modelli di consumer OLE DB
Riferimenti ai modelli consumer OLE DB