odm_mount_class 子例程
用途
检索所指定对象类名的类符号结构。
库
对象数据管理器库 (libodm.a)
语法
#include <odmi.h>
CLASS_SYMBOL odm_mount_class ( ClassName)
char *ClassName;描述
odm_mount_class 子例程检索指定对象类的类符号结构。 该子例程可由应用程序 (例如, ODM 命令) 调用,这些应用程序在尝试访问对象类之前对该对象类的结构没有任何了解。 odm_mount_class 子例程根据对象类头信息确定类描述,并创建返回给调用者的 CLASS_SYMBOL 对象类。
对象类未由 odm_mount_class 子例程打开。 对已打开或已安装的对象类调用子例程后续时间将返回相同的 CLASS_SYMBOL 对象类。
以递归方式将链接到另一个对象类的类安装到链接的类。 但是,如果递归安装失败,那么原始 odm_mount_class 子例程不会失败; CLASS_SYMBOL 对象类设置为空链接。
参数
| 项 | 描述 |
|---|---|
| ClassName | 指定要从其中检索类描述的对象类的名称。 |
返回值
成功完成后,将返回 CLASS_SYMBOL 。 如果 "odm_mount_class子程序不成功,则返回值为-1,并将odmerrno变量设置为错误代码。
错误代码
odm_mount_class 子例程的失败将 odmerrno 变量设置为下列其中一个错误代码:
- odmi_bad_classname
- odmi_bad_clxnname
- ODMI_CLASS_DNE
- odmi_class_perms
- Odmi_CLxnmagicno_ERR
- odmi_invalid_class
- odmi_invalid_clxn
- odmi_magicnoo_err
- odmi_malloc_err
- ODMI_OPEN_ERR
- ODMI_PARAMS
- odmi_toomanyclasses
- odmi_toomanyclasses
请参阅 对象数据管理器 (ODM) 错误代码 ,以获取 ODM 错误代码的说明。