exos_datamodel_delete()

<< 点击显示目录 >>

主页  exOS使用助手 > exOS Automation Help > Development > Programming > exOS Communication API reference (exos_api.h) >

exos_datamodel_delete()

释放数据模型的所有资源(并断开与数据集消息路由器的连接)

调用语法

EXOS_ERROR_CODE exos_datamodel_delete(exos_datamodel_handle_t *datamodel);

此函数将释放为该数据模型分配的所有内存,包括所有已分配的数据集。如果与 数据集消息路由器的连接 处于 活动状态,则会自动断开,与当前数据模型状态无关 。在数据模型句柄 _t 上调用 exos_datamodel_delete () 之后 ,该句柄将变为无效,需要使用 exos_datamodel_init() 重新初始化 。因此,exos_datamodel_delete() 通常在整个应用程序退出时调用,而 exos_datamodel_disconnect()则 可以在 "操作过程中 "调用,只是为了(暂时)关闭连接。

 

参数

datamodel:数据模型句柄,以指针形式给出


Release all resources from a datamodel (and disconnect from the Dataset Message Router)

Call syntax

EXOS_ERROR_CODE exos_datamodel_delete(exos_datamodel_handle_t *datamodel);

This function will free up all allocated memory allocated for this datamodel, including all assigned datasets. If a connection to the Dataset Message Router is active, it will be disconnected automatically, independent of the current datamodel state. After the exos_datamodel_delete() has been called on a datamodel_handle_t, this handle becomes invalid and needs to be reinitialized using exos_datamodel_init(). Therefore, the exos_datamodel_delete() is mostly called when the entire application exits, whereas the exos_datamodel_disconnect() can be called "during operation", just to close the connection (temporarily).

 

Parameters

datamodel: datamodel handle, given as a pointer