DATASERV (kdataman) functions
LIBRARY ROUTINE
kdms_destroy_attribute - destroy an attribute
LIBRARY CALL
int kdms_destroy_attribute(
kobject object,
char *segment,
char *attribute)
INPUT
- object - the object with the attribute to destroy
- segment - the segment which contains the
attribute. If this is NULL, then
the attribute is assumed to exist
at the object level.
- attribute - string identifying the name of the
attribute to destroy.
OUTPUT
none
RETURN VALUE
TRUE on success, FALSE otherwise
DESCRIPTION
This routine provides the programmer with a
mechanism for destroying an instantiation
of an attribute.
The segment argument is used to indicate which
segment the attribute exists in. If the segment
argument is NULL, then the attribute is assumed
to exist at the object level.
If the attribute is not physically instantiated
on the object, then it can not be destroyed.
In general, this routine should only be used
to destroy attributes that have been explicitly
created with a kdms_create_attribute call.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DATASERV/objects/library/kdataman/src/attributes.c
SEE ALSO
kdataman(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.