.\" pragma ident "@(#)KcsFreeProfile.3	1.3  04/21/95"
.TH KcsFreeProfile 3 "21 April 1995" "" "KCMS Library"
.SH NAME
KcsFreeProfile \- Deallocate resources associated with a profile
.SH SYNOPSIS
.ft B
.nf
#include <kcms/kcs.h>
#include <kcms/kcstypes.h>
.sp
KcsStatusId KcsFreeProfile(KcsProfileId    profile)
.fi
.ft R
.SH MT-LEVEL
MT-Unsafe
.SH DESCRIPTION
Use 
.B KcsFreeProfile()
to deallocate all of the resources a 
loaded profile is using. A loaded profile uses memory and 
additional types of resources.
.PP
The KCMS library does not automatically save profile 
changes when your application terminates. In order to save 
profile changes, you must call KcsSaveProfile(3).
.SH ARGUMENTS
.TP
.SB profile
The identifier of a loaded profile.
.SH RETURN VALUES
Upon successful completion KCS_SUCCESS is returned. Otherwise
one of the following errors will be returned.
.SH ERRORS
KCS_PROF_ID_BAD
.SH SEE ALSO
.BR KcsLoadProfile (3)
.BR KcsModifyLoadHints (3)
.BR KcsSaveProfile (3)
.br
.BR "KCMS Application Developers Guide"
.SH NOTE
If the application passes in a KcsFileProfile type of KcsProfileDesc as 
an argument, then 
.B KcsFreeProfile(3)i
does not close the KcsFileId contained in the file entry of the 
KcsProfileDesc union.
.SH EXAMPLE
.nf
KcsProfileId	profile;

/* after processing is completed, you may free the profile */
KcsFreeProfile(profile);
.fi