CSession (Clase)

Representa una única sesión de acceso a la base de datos.

Sintaxis

class CSession

Requisitos

Encabezado: atldbcli.h

Miembros

Métodos

Nombre	Descripción
Abort	Cancela (finaliza) la transacción.
Cerrar	Cierra la sesión.
Confirmar	Confirma la transacción.
GetTransactionInfo	Devuelve información relacionada con una transacción.
Abierta	Abre una nueva sesión para el objeto de origen de datos.
StartTransaction	Comienza una nueva transacción para esta sesión.

Comentarios

Se pueden asociar una o varias sesiones a cada conexión de proveedor (origen de datos), que se representa con un objeto CDataSource. Para crear un nuevo CSession para un CDataSource, llame a CSession::Open. Para iniciar una transacción de base de datos, CSession proporciona el método StartTransaction. Una vez iniciada una transacción, puede confirmarla con el método Commit o cancelarla con el método Abort.

CSession::Abort

Finaliza la transacción.

Sintaxis

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

Parámetros

Consulte ITransaction::Abort en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

CSession::Close

Cierra la sesión, que se abrió con CSession::Open.

Sintaxis

void Close() throw();

Comentarios

Libera el puntero m_spOpenRowset.

CSession::Commit

Confirma la transacción.

Sintaxis

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

Parámetros

Consulte ITransaction::Commit en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

Comentarios

Para obtener más información, consulte ITransaction::Commit.

CSession::GetTransactionInfo

Devuelve información relacionada con una transacción.

Sintaxis

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

Parámetros

Consulte ITransaction::GetTransactionInfo en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

Comentarios

Para obtener más información, consulte ITransaction::GetTransactionInfo en la Referencia del programador de OLE DB.

CSession::Open

Abre una nueva sesión para el objeto de origen de datos.

Sintaxis

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

Parámetros

ds
[in] Origen de datos para el que se va a abrir la sesión.

pPropSet
[in] Puntero a una matriz de estructuras DBPROPSET que contiene las propiedades y los valores que se van a establecer. Vea Conjuntos de propiedades y grupos de propiedades en la referencia del programador OLE DB de Windows SDK.

ulPropSets
[in] Número de estructuras DBPROPSET pasadas en el argumento pPropSet.

Valor devuelto

Un HRESULT estándar.

Comentarios

Debe abrir el objeto de origen de datos con CDataSource::Open antes de pasarlo a CSession::Open.

CSession::StartTransaction

Comienza una nueva transacción para esta sesión.

Sintaxis

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

Parámetros

Consulte ITransactionLocal::StartTransaction en la Referencia del programador de OLE DB.

Valor devuelto

Un HRESULT estándar.

Comentarios

Para obtener más información, consulte ITransactionLocal::StartTransaction en la Referencia del programador de OLE DB.

Consulte también

CatDB
Plantillas de consumidor OLE DB
Referencia de plantillas de consumidor OLE DB