Ovis_Entity_From_Objhandle_Create()
摘要
使用站点的 ETS 对象句柄创建 Ovis 实体。
语法
Ovis_Entity_From_Objhandle_Create (ets_obj_handle, callback, state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
ets_obj_handle |
EtsT_Obj_Handle |
站点的 ETS 对象句柄 |
callback |
OvisT_Entity_State_Destroy_Proc | 在实体被销毁时销毁该实体状态的回调函数 |
state_ptr |
void * |
与实体关联的用户自定义状态 |
返回类型
OvisT_Entity *
返回该实体;若函数未能返回实体则返回 OVISC_NIL。
头文件
ovis_entity.h
详情
该函数基于 ETS 对象句柄所引用的站点创建 Ovis 实体。如果指定站点已经关联了实体,函数将返回已存在的实体(已存在的状态和销毁过程不会因提供的参数而更新)。该函数只能在 ETS 函数调用的上下文中使用。
示例
OvisT_Entity * ent_ptr;
EtsT_Obj_Handle handle;
/* handle set to some appropriate node or subnet */
ent_ptr = Ovis_Entity_From_Objhandle_Create (handle, OPC_NIL, OPC_NIL);
错误
- 无
参考
- 无