odm_add_obj 子例程
用途
将新对象添加到对象类中。
库
对象数据管理器库 (libodm.a)
语法
#include <odmi.h>
int odm_add_obj ( ClassSymbol, DataStructure)
CLASS_SYMBOL ClassSymbol;
struct ClassName *DataStructure;描述
odm_add_obj 子例程将用于标识要添加的对象类和指向包含要添加的对象的数据结构的指针的类符号作为输入。
如果先前未打开对象类，那么 odm_add_obj 子例程将打开并关闭子例程周围的对象类。 如果先前打开了对象类，那么子例程在返回时使对象类保持打开状态。
参数
| 项 | 描述 |
|---|---|
| ClassSymbol | 指定从 odm_open_class 子例程返回的类符号标识。 如果尚未调用 odm_open_class 子例程，那么此标识是由 odmcreate 命令创建的 ClassName_CLASS 结构。 |
| DataStructure | 指定对应于 ClassSymbol 参数引用的对象类的 C 语言结构实例的指针。 该结构在 odmcreate 命令创建的 .h 文件中声明，并且具有与对象类相同的名称。 |
返回值
在成功完成后，将返回已添加的对象的标识。 如果 "odm_add_obj子程序不成功，则返回值为-1并将 "odmerrno变量设置为错误代码。
错误代码
odm_add_obj 子例程的失败将 odmerrno 变量设置为下列其中一个错误代码:
- ODMI_CLASS_DNE
- odmi_class_perms
- odmi_invalid_clxn
- odmi_invalid_path
- odmi_magicnoo_err
- ODMI_OPEN_ERR
- ODMI_PARAMS
- ODMI_READ_ONLY
- odmi_toomanyclasses
请参阅 对象数据管理器 (ODM) 错误代码 ，以获取 ODM 错误代码的说明。