DATASERV (kappserv) functions


LIBRARY ROUTINE

kpds_destroy_mask - destroy the mask segment in a data object.

LIBRARY CALL

int kpds_destroy_mask(
   kobject object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE if the mask segment is successfully destroyed, FALSE otherwise

DESCRIPTION

This function is used to destroy the mask segment contained within an object. Once the mask segment has been destroyed, any data or attributes associated with the mask data will be lost forever. A new mask segment can be created in its place with the function kpds_create_mask.

If the mask segment does not exist in the specified object, it is considered to be an error.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kappserv/src/pds_mask.c

SEE ALSO

kappserv(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.