Classe CSession

Representa uma sessão de acesso ao banco de dados individual.

Sintaxe

class CSession

Requisitos

Cabeçalho: atldbcli.h

Membros

Métodos

Nome	Descrição
Anular	Cancela (termina) a transação.
Fechar	Fecha a sessão.
Confirmar	Confirma a transação.
GetTransactionInfo	Retorna informações sobre uma transação.
Aberto	Abre uma nova sessão para o objeto de fonte de dados.
StartTransaction	Inicia uma nova transação para esta sessão.

Comentários

Uma ou mais sessões podem estar associadas a cada conexão de provedor (fonte de dados), que é representada por um objeto CDataSource. Para criar uma nova CSession para CDataSource, chame CSession::Open. Para iniciar uma transação de banco de dados, CSession fornece o método StartTransaction. Depois que uma transação for iniciada, você poderá confirmá-la usando o método Commit ou cancelá-la usando o método Abort.

CSession::Abort

Termina a transação.

Sintaxe

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

Parâmetros

Consulte ITransaction::Abort na Referência do Programador do OLE DB.

Valor de Devolução

Um valor HRESULT padrão.

CSession::Close

Fecha a sessão que foi aberta por CSession::Open.

Sintaxe

void Close() throw();

Comentários

Libera o ponteiro m_spOpenRowset.

CSession::Commit

Confirma a transação.

Sintaxe

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

Parâmetros

Consulte ITransaction::Abort na Referência do Programador do OLE DB.

Valor de Devolução

Um valor HRESULT padrão.

Comentários

Para mais informações, consulte ITransaction::Commit.

CSession::GetTransactionInfo

Retorna informações sobre uma transação.

Sintaxe

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

Parâmetros

Consulte ITransaction::GetTransactionInfo na Referência do programador do OLE DB.

Valor de Devolução

Um valor HRESULT padrão.

Comentários

Para mais informações, consulte ITransaction::GetTransactionInfo na Referência do programador do OLE DB.

CSession::Open

Abre uma nova sessão para o objeto de fonte de dados.

Sintaxe

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

Parâmetros

ds
[in] A fonte de dados para a qual a sessão será aberta.

pPropSet
[in] Um ponteiro para uma matriz de estruturas DBPROPSET que contêm propriedades e valores a serem definidos. Confira Conjuntos de propriedades e grupos de propriedades na Referência do programador OLE DB no SDK do Windows.

ulPropSets
[in] O número de estruturas DBPROPSET passadas no argumento pPropSet.

Valor de Devolução

Um valor HRESULT padrão.

Comentários

Você deve abrir o objeto de fonte de dados usando CDataSource::Open antes de passá-lo para CSession::Open.

CSession::StartTransaction

Inicia uma nova transação para esta sessão.

Sintaxe

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

Parâmetros

Consulte ITransactionLocal::StartTransaction na Referência do programador do OLE DB.

Valor de Devolução

Um valor HRESULT padrão.

Comentários

Para mais informações, consulte ITransactionLocal::StartTransaction na Referência do programador do OLE DB.

Confira também

CatDB
Modelos de consumidor OLE DB
Referência de modelos de consumidor do OLE DB