cniFinalize

导致代理请求解析器支持在指定的消息上执行其最终化处理的最终化功能。此处理行为特定于每个解析器。

如果 options 参数设置为 CCI_FINALIZE_VALIDATE,则解析器还应该执行验证处理来确保其拥有的元素树的结构是正确的。这对阻止将具有不正确格式的元素树的消息传播到消息流中的其他节点是有帮助的。

建议在传播消息前调用 cniFinalize,(例如,在调用 cniWriteBuffer 前)。

语法

void cniFinalize(
    int*                returnCode,
  CciMessage* message,
    int                        options);

参数

returnCode
来自函数(输出)的返回码。
可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
要最终化的元素树的消息对象的地址(输入)。
options
指定位标志来标识最终化或验证要使用的选项(输入)。此参数是可选的。您可以将它设置为 CCI_FINALIZE_VALIDATE。

返回值

无。如果发生错误,则 returnCode 参数表明错误原因。

示例

      cniFinalize(&rc, outMsg, CCI_FINALIZE_NONE);
            retvalue = cniPropagate(
                                                                                &rc,
                                                          terminalObject, 
                                                          destinationList, 
                                                          exceptionList, 
                                                          outMsg);

      	 /* Handle errors */
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as07590_