cpiElementName

用途

获取目标语法元素的名称。语法元素名称已预先使用 cniSetElementNamecpiSetElementName 进行设置。

语法

Ccisize           cpiElementName(
    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,并且返回需要的字符数。对于任何其他故障,返回 CCI_FAILURE,并且 returnCode 表明错误的原因。

样本

cpiElementName(&rc;, element, (CciChar*)&elementName;, sizeof(elementName));
相关概念
用户定义的解析器
用户定义的扩展
相关任务
使用 C 创建解析器
相关参考
cpiElementType
cpiElementValue group
cpiElementValueValue
C 解析器实用程序函数
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as08430_