cniCreateElementBefore

创建新语法元素并在指定的语法元素前插入它。新元素成为指定元素的前一个兄弟,并且共享相同的父代元素。

当创建消息体文件夹(如 XML、XMLNS、MRM 和 BLOB)时,不应使用 cniCreateElementBefore,这是因为它不会将所属的解析器与此文件夹相关联。要创建消息体文件夹,可以使用以下任何函数:
   cniCreateElementAsFirstChildUsingParser   cniCreateElementAsLastChildUsingParser
   cniCreateElementAfterUsingParser
   cniCreateElementBeforeUsingParser
当创建了消息体文件夹时,您可以使用 cniCreateElementBefore 在文件夹下创建元素。因为与消息体文件夹关联的解析器是通过继承得到的,所以您可以使用 cniCreateElementBefore

语法

CciElement* cniCreateElementBefore(
    int*                returnCode,
    CciElement*    targetElement);

参数

returnCode
来自函数(输出)的返回码。
可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
目标元素对象的地址(输入)。

返回值

如果成功,返回新元素对象的地址。否则,返回值零(CCI_NULL_ADDR),并且 returnCode 参数表明错误的原因。

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