.\" pragma ident "@(#)KcsGetAttribute.3	1.3  04/21/95"
.TH KcsGetAttribute 3 "21 April 1995" "" "KCMS Library"
.SH NAME
KcsGetAttribute \- Find the value of a profile attribute
.SH SYNOPSIS
.ft B
.nf
#include <kcms/kcs.h>
#include <kcms/kcstypes.h>
#include <kcms/icc.h>
.sp
KcsStatusId KcsGetAttribute(
		KcsProfileId 		profile, 
		KcsAttributeName	name,
		KcsAttributeValue	*value)
.fi
.ft R
.SH MT-LEVEL
MT-Unsafe
.SH DESCRIPTION
Use 
.B KcsGetAttribute() 
to find the value of a particular attribute of the given profile. 
.SH ARGUMENTS
.TP
.SB profile
The identifier of the loaded profile.
.TP
.SB name
ICC Tag name
.TP
.SB value
A pointer to the structure to hold the value of the profile's 
attribute. You need to set countSupplied field in the value 
argument. If you do not set it, you may see the warning 
KCS_ATTR_LARGE_CT_SUPPLIED or the error 
KCS_ATTR_CT_ZERO_OR_NEG returned.
.SH RETURN VALUES
Upon successful completion KCS_SUCCESS is returned. Otherwise
one of the following errors will be returned.
.SH ERRORS
.nf
KCS_PROF_ID_BAD
KCS_ATTR_NAME_OUT_OF_RANGE
KCS_ATTR_CT_ZERO_OR_NEG
KCS_ATTR_LARGE_CT_SUPPLIED (warning)
.fi
.SH SEE ALSO
.BR KcsLoadProfile (3)
.BR KcsSetAttribute (3)
.br
.BR "KCMS Application Developers Guide"
.SH NOTE
icSigAtoB[0-2]Tag, icSigBToA[0-2]Tag, and icSigGamutTag are considered 
transforms by the KCMS library and are not valid values for name.