cniElementName

为指定的语法元素获取名称属性的值。语法元素名称已预先使用 cniSetElementNamecpiSetElementName 进行设置。

语法

CciSize cniElementName(
    int*                returnCode,
    CciElement*               targetElement,
    const CciChar*             value,
    Ccisize         length);

参数

returnCode
来自函数(输出)的返回码。
可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
目标语法元素对象(输入)的地址。
value
在其内复制元素名称的缓冲区的地址(输入)。
length
长度(以字符为单位),由 value 参数指定(输入)。

返回值

  • 如果成功,将元素名称复制到所提供的缓冲区并返回复制的 CciChar 字符数。
  • 如果缓冲区的大小不足以包含属性值,则 returnCode 设置为 CCI_BUFFER_TOO_SMALL,并且返回需要的 CciChars 数。
  • 对于任何其他故障,返回 CCI_FAILURE,并且 returnCode 表明错误的原因。
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as07890_