CSession, classe

Représente une session d’accès à une base de données unique.

Syntaxe

class CSession

Spécifications

En-tête : atldbcli.h

Membres

Méthodes

Notes

Une ou plusieurs sessions peuvent être associées à chaque connexion fournisseur (source de données), représentée par un objet CDataSource . Pour créer un CSession nouveau pour un CDataSource, appelez CSession ::Open. Pour commencer une transaction de base de données, CSession fournit la StartTransaction méthode. Une fois qu’une transaction est démarrée, vous pouvez la valider à l’aide de la Commit méthode ou l’annuler à l’aide de la Abort méthode.

CSession::Abort

Termine la transaction.

Syntaxe

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

Paramètres

Voir ITransaction ::Abort dans la référence du programmeur OLE DB.

Valeur de retour

HRESULT standard.

CSession::Close

Ferme la session, qui a été ouverte par CSession ::Open.

Syntaxe

void Close() throw();

Notes

Libère le m_spOpenRowset pointeur.

CSession::Commit

Valide la transaction.

Syntaxe

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

Paramètres

Consultez ITransaction ::Commit dans la référence du programmeur OLE DB.

Valeur de retour

HRESULT standard.

Notes

Pour plus d’informations, consultez ITransaction ::Commit.

CSession::GetTransactionInfo

Retourne des informations concernant une transaction.

Syntaxe

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

Paramètres

Consultez ITransaction ::GetTransactionInfo dans la référence du programmeur OLE DB.

Valeur de retour

HRESULT standard.

Notes

Pour plus d’informations, consultez ITransaction ::GetTransactionInfo dans la référence du programmeur OLE DB.

CSession::Open

Ouvre une nouvelle session pour l’objet source de données.

Syntaxe

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

Paramètres

Ds
[in] Source de données pour laquelle la session doit être ouverte.

pPropSet
[in] Pointeur vers un tableau de structures DBPROPSET contenant des propriétés et des valeurs à définir. Consultez Les ensembles de propriétés et les groupes de propriétés dans la référence du programmeur OLE DB dans le Kit de développement logiciel (SDK) Windows.

ulPropSets
[in] Nombre de structures DBPROPSET passées dans l’argument pPropSet .

Valeur de retour

HRESULT standard.

Notes

Vous devez ouvrir l’objet de source de données à l’aide de CDataSource ::Open avant de le transmettre.CSession::Open

CSession::StartTransaction

Commence une nouvelle transaction pour cette session.

Syntaxe

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

Paramètres

Consultez ITransactionLocal ::StartTransaction dans la référence du programmeur OLE DB.

Valeur de retour

HRESULT standard.

Notes

Pour plus d’informations, consultez ITransactionLocal ::StartTransaction dans la référence du programmeur OLE DB.

Voir aussi

CatDB
Modèles du consommateur OLE DB
Référence des modèles du consommateur OLE DB