DATASERV (kappserv) functions


LIBRARY ROUTINE

kpds_close_object - close an open data object.

LIBRARY CALL

int kpds_close_object(
   kobject object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE (1) if object is closed successfully, FALSE (0) otherwise

DESCRIPTION

This function is called on an object when all interaction with the object is complete. In addition to freeing resources that were used to manage the object, this function also writes any component of the data set that has not yet been written and may alter index order and datatype of the data to that is supported by the file format.

If the object was created with the kpds_reference_object function call, or if another object was created as a reference of the one being closed, then the object might be sharing some of its resources with other objects. If this is the case, then those shared resources will not be freed, but rather they will be disassociated from the object being closed. Thus, closing an object does not affect any other object.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/include/kappserv/kpolymorphic.h

SEE ALSO

kappserv(3)

COPYRIGHT

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