op_apptrack_instance_create()
摘要
创建新的应用实例。
语法
op_apptrack_instance_create (apptrack_hndl, source, app_type_id, app_instance_name)
| 参数 | 类型 | 说明 |
|---|---|---|
apptrack_hndl |
Apptrackhandle |
所关注的 ADT 状态。 |
source |
Objid |
包含待跟踪应用的节点的对象 ID。 |
app_type_id |
OpT_uInt32 |
通过 op_apptrack_type_register() 获得的应用类型 ID。 |
app_instance_name |
const char * |
该应用实例的名称。 |
返回类型
OpT_uInt32
全局唯一的应用实例 ID;若发生错误则返回 OPC_APPTRACK_APP_INSTANCE_INVALID。
详情
应用实例 ID 从 0 开始。重复调用会返回新的应用实例 ID。
用途
该内核过程创建新的应用实例并初始化其开始时间。
错误
- 可恢复错误:参数 (
apptrack_hndl) 为 NIL。 - 可恢复错误:对象 ID (
<source>) 超出范围。 - 可恢复错误:源对象 ID (
<source>) 指向受限对象。 - 可恢复错误:对象 (
<source>) 类型不正确 (<type>);应为节点对象。 - 可恢复错误:参数 app_type_id (
<app_type_id>) 无效。 - 可恢复错误:参数 (
app_instance_name) 为 NIL。
参考
- 使用内核过程 op_apptrack_instance_complete() 记录应用实例已完成。
- 使用内核过程 op_apptrack_create() 创建
apptrack_hndl。 - 使用内核过程 op_apptrack_type_register() 创建应用类型 ID。