op_ev_id_str_get()
摘要
获取事件 ID 的字符串表示。
语法
op_ev_id_str_get (evhandle, buffer)
| 参数 | 类型 | 说明 |
|---|---|---|
evhandle |
Evhandle |
目标事件的 ID |
buffer |
char * |
用于存放事件 ID 字符串表示的变量 |
返回类型
Compcode
若成功获取事件 ID 字符串则返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
char ev_id_str[20];
/* Get the currently executing event */
evptr = op_ev_current ();
/* Get the event ID as a string */
op_ev_id_str_get (evptr, ev_id_str);
详情
如果仿真使用基于模块的 ID 生成,返回的字符串由事件创建所在模块的 ID(如果由仿真创建则为 “kernel”)以及该模块中的创建索引组成。否则,它只是全局事件创建索引。
使用基于模块的 ID 生成时,该内核过程比直接使用 OPC_EV_ID_FMT 将 ID 打印为字符串能产生更好的输出。
用途
提供了一种获取格式规范的事件 ID 字符串表示的方法,无论 ID 生成是基于模块还是全局的。
错误
- 可恢复错误:事件句柄指向的事件无效或当前未被计划。
参考
- 使用内核过程 op_ev_id() 获取事件 ID