Ovis_Group_Parent_Set()
Abstract
Specifies the parent of an Ovis group.
Syntax
Ovis_Group_Parent_Set (group_ptr, parent_ptr)
| Argument | Type | Description |
|---|---|---|
group_ptr |
OvisT_Group * |
Ovis group |
parent_ptr |
OvisT_Group * |
Ovis parent group |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the parent can be set; OvisC_Compcode_Failure otherwise.
Header
ovis_entity.h
Details
This function accesses the group hierarchy and specifies the parent of the Ovis group in the hierarchy.
Example
OvisT_Group * parent, * child;
/* …child and parent created elsewhere */
Ovis_Group_Parent_Set (child, parent);
Errors
- Child group is NIL.
Reference
- Use the function
Ovis_Group_Parent_Get()to get the parent group of a group. - Use the function
Ovis_Group_Child_Group_Count()to get the number of child groups of a group. - Use the function
Ovis_Group_Child_Group_Nth()to get one child group of a group.