ihuEnumeratedStateDelete

Use the ihuEnumeratedStateDelete function to delete a state from an enumerated set.

Prototype

ihuEnumeratedStateDelete
( in long serverhandle,
in MSO Char *EnumeratedSetName,
in MSO Char *EnumeratedStateName
)

Remarks

When only one state is available in a set, you cannot delete the state. The only way to delete the state is to delete the set. There is no need to delete each state before you delete a set.

You must be an administrator of a set to delete its associated states.

Returns

The ihuEnumeratedStateDelete function returns ihuSTATUS_OK on success, or returns errors on:

  • Invalid input parameters
  • No set name that matches EnumeratedSetName value
  • No state name that matches EnumeratedStateName value
  • Out-of-memory issues during dynamic memory allocation
  • User not a member of ihTag Admin group
Note: Set the Administrator parameter to the ihTag Admin security group to assign the highest precedence to this parameter.