Inicio del cambio

cciTransactionEventCallback

Esta es una función que se puede registrar como una devolución de llamada y se invoca cuando una transacción de flujo de mensajes finaliza. Se invoca para todas las transacciones de flujo de mensajes dentro del grupo de ejecución en el que se registró la devolución de llamada, si el estado de la rutina de salida de usuario es activo. La devolución de llamada se registra proporcionando un puntero a la función en el campo iFpTransactionEventCallback de la estructura CCI_UE_VFT que pasa a cciRegisterUserExit.

Sintaxis

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

Parámetros

userContext (entrada)
Éste es el valor pasado a la función cciRegisterUserExit.
type
Describe el suceso que se produjo. Los valores posibles son:
  • CCI_TRANSACTION_EVENT_COMMIT

    Se ha confirmado una transacción correctamente.

  • CCI_TRANSACTION_EVENT_ROLLBACK

    Se ha restituido una transacción.

Si la transacción se ha restituido debido a una excepción no manejada, los detalles de dicha excepción pueden obtenerse invocando cciGetLastExceptionData.
environment
Éste es un manejador para el objeto de entorno para el flujo de mensajes actual. Aunque la rutina de salida de usuario puede actualizar este árbol, se borra después de volver de esta función, por lo que cualquier actualización se perderá.
inputNode
Éste es un manejador para el nodo de entrada que lee el mensaje de entrada que desencadenó la transacción. Puede utilizarse para hacer llamadas a funciones como por ejemplocciGetNodeName, cciGetNodeType y cniGetBrokerInfo.

Valores de retorno

Ninguno

Ejemplo

void myTransactionEventCallback(
CciDataContext* userContext,
CciTransactionEventType type,
CciMessage* environment,
CciNode* inputNode){
…
…
}
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
as35960_


Fin del cambio