NAME    [Toc]    [Back]

       CL_FreeFieldValue,  CSSM_CL_FreeFieldValue  -  Free  field
       data (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:    CSSM_RETURN     CSSMAPI     CSSM_CL_FreeFieldValue
       (CSSM_CL_HANDLE  CLHandle,  const  CSSM_OID *CertOrCrlOid,
       CSSM_DATA_PTR    Value)    SPI:    CSSM_RETURN     CSSMCLI
       CL_FreeFieldValue (CSSM_CL_HANDLE CLHandle, const CSSM_OID
       *CertOrCrlOid, CSSM_DATA_PTR Value)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in  Certificate  Library
       module  used  to  perform this function.  A pointer to the
       CSSM_OID structure describing the type of the Value to  be
       freed.   A  pointer  to the CSSM_DATA structure containing
       the Data to be freed.

DESCRIPTION    [Toc]    [Back]

       This function  frees  the  data  specified  by  Value  and
       Value->Data.   CertOrCrlOid indicates the type of the data
       in Value.

       This function should be used only to free CSSM_DATA values
       returned   from   calls  CSSM_CL_CertGetFirstFieldValue(),
       CSSM_CL_CertGetNextFieldValue(),     CSSM_CL_CertGetFirstCachedFieldValue(),
 CSSM_CL_CertGetNextCachedFieldValue(),
       CSSM_CL_CrlGetFirstFieldValue(),  CSSM_CL_CrlGetNextFieldValue(),
            CSSM_CL_CrlGetFirstCachedFieldValue(),
       CSSM_CL_CrlGetNextCachedFieldValue(),  or  their  CLI  SPI
       equivalents.

RETURN VALUE    [Toc]    [Back]

       A  CSSM_RETURN  value  indicating  success or specifying a
       particular error condition. The  value  CSSM_OK  indicates
       success. All other values represent an error condition.

ERRORS    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).  CSSMERR_CL_UNKNOWN_TAG

SEE ALSO    [Toc]    [Back]

       Intel   CDSA   Application    Developer's    Guide    (see
       CDSA_intro(3))



                                             CL_FreeFieldValue(3)