cpiCreateContext

用途

创建与解析器对象关联的用户定义的扩展上下文。当构造或分配解析器对象的实例时,由消息代理调用它。当消息流导致要解析消息数据时发生此情况;代理构造或分配解析器对象来获取消息数据的相应部分。在调用此函数前,代理已经将名元素作为有效的根元素为解析器进行了创建。然而,未命名此元素。解析器应该在 cpiSetElementName 函数中命名此元素。

扩展的责任是:
  1. 分配可能需要的任何解析器实例特定的数据区(例如,上下文)。
  2. 执行可能需要的任何其他资源购置或初始化。
  3. 将上下文的地址返回到正在调用的函数。无论何时调用此解析器实例的实施函数,相应的上下文都会作为参数传递到该函数。这意味着使用 C 开发的用户定义的解析器不需要在每个实例数据区维护 自己的静态指针。
在其中定义 类型 成员
CPI_VFT 必需 iFpCreateContext

语法

void cpiCreateContext(
    CciParser*  parser);

参数

parser
解析器对象的地址(输入)。

返回值

如果成功,则会返回用户定义的扩展上下文的地址。否则,返回值 0。

相关概念
用户定义的解析器
用户定义的扩展
相关参考
C 解析器实施函数
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as08095_