cciTransactionEventCallback

这是一个可以注册为回调的函数,每当消息流事务结束时都会调用它。如果用户出口处于活动状态,则在注册回调的执行组中会为每个消息流事务调用该函数。通过提供指向传递到 cciRegisterUserExit 的 CCI_UE_VFT 结构的 iFpTransactionEventCallback 字段中的函数的指针,可以注册回调。

语法

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

参数

userContext(输入)
这是传递到 cciRegisterUserExit 函数的值。
type
这描述了发生的事件。可能的值是:
  • CCI_TRANSACTION_EVENT_COMMIT

    事务已成功落实。

  • CCI_TRANSACTION_EVENT_ROLLBACK

    事务已回滚。

如果由于未解决的异常而使事务回滚,则调用 cciGetLastExceptionData 可以获取该异常的详细信息。
environment
这是当前消息流的环境对象的句柄。虽然用户出口可以更新此树,但是在从此函数返回后它会被清除,因此所有的更新都会丢失。
inputNode
这是输入节点的句柄,该节点可以读取触发事务的输入消息。它可用来调用诸如 cciGetNodeNamecciGetNodeTypecniGetBrokerInfo 的函数。

返回值

示例

void myTransactionEventCallback(
                     CciDataContext* userContext,
                     CciTransactionEventType type,
                     CciMessage* environment,
                     CciNode* inputNode){
…
…
}
相关概念
建立用户出口
相关任务
建立用户出口
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as35960_