odm_rm_obj Subroutine
Purpose
Removes objects from an ODM object class.
Library
Object Data Manager Library (libodm.a)
Syntax
#include <odmi.h>Description
The odm_rm_obj subroutine deletes objects from an object class.
Parameters
| Item | Description |
|---|---|
| ClassSymbol | Identifies a class symbol returned from an odm_open_class subroutine. If the odm_open_class subroutine has not been called, this is the ClassName_CLASS structure that was created by the odmcreate command. |
| Criteria | Contains as a string the qualifying criteria for selecting the objects to remove. |
Return Values
Upon successful completion, the number of objects deleted is returned. If the odm_rm_obj subroutine is unsuccessful, a value of -1 is returned and the odmerrno variable is set to an error code.
Error Codes
Failure of the odm_rm_obj subroutine sets the odmerrno variable to one of the following error codes:
- ODMI_BAD_CRIT
- ODMI_CLASS_DNE
- ODMI_CLASS_PERMS
- ODMI_FORK
- ODMI_INTERNAL_ERR
- ODMI_INVALID_CLXN
- ODMI_INVALID_PATH
- ODMI_MAGICNO_ERR
- ODMI_MALLOC_ERR
- ODMI_OPEN_ERR
- ODMI_OPEN_PIPE
- ODMI_PARAMS
- ODMI_READ_ONLY
- ODMI_READ_PIPE
- ODMI_TOOMANYCLASSES
See Object Data Manager (ODM) error codes for explanations of the ODM error codes.