cciTransactionEventCallback

Esta é uma função que pode ser registrada como um retorno de chamada e é chamada sempre que uma transação de fluxo de mensagem é encerrada. Ela é chamada para cada transação de fluxo de mensagem dentro do grupo de execução em que o retorno de chamada foi registrado, se o estado de saída de usuário é ativo. O retorno de chamada é registrado fornecendo um ponteiro para a função no campo iFpTransactionEventCallback da estrutura CCI_UE_VFT transmitida para cciRegisterUserExit.

Sintaxe

typedef void (*cciTransactionEventCallback) (
                                 CciDataContext* userContext,
                                 CciTransactionEventType type,
                                 CciMessage* environment,
                                 CciNode* inputNode);

Parâmetros

userContext (entrada)
Este é o valor que foi transmitido para a função cciRegisterUserExit.
type
Descreve o evento ocorrido. Os valores possíveis são:
  • CCI_TRANSACTION_EVENT_COMMIT

    Uma transação foi confirmada com sucesso.

  • CCI_TRANSACTION_EVENT_ROLLBACK

    Uma transação teve rollback.

Se a transação teve rollback devido a uma exceção não manipulada, então os detalhes da exceção podem ser obtidos pela chamada de cciGetLastExceptionData.
environment
Esta é uma manipulação para o objeto de ambiente para o fluxo de mensagens atual. Embora a saída de usuário possa atualizar essa árvore, ela é limpa após o retorno dessa função. Então, quaisquer atualizações serão perdidas.
inputNode
Esta é uma manipulação para o nó input que lê a mensagem de entrada que acionou a transação. Ela pode ser utilizada para fazer chamadas para funções como cciGetNodeName, cciGetNodeType e cniGetBrokerInfo.

Valores de Retorno

Nenhum

Exemplo

void myTransactionEventCallback(
                     CciDataContext* userContext,
                     CciTransactionEventType type,
                     CciMessage* environment,
                     CciNode* inputNode){
…
…
}
Conceitos relacionados
Desenvolvendo Saídas do Usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as35960_