NAME    [Toc]    [Back]

       CL_FreeFields, CSSM_CL_FreeFields - Free fields (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:  CSSM_RETURN CSSMAPI CSSM_CL_FreeFields (CSSM_CL_HANDLE
 CLHandle, uint32 NumberOfFields, CSSM_FIELD_PTR *FieldArray)
    SPI:    CSSM_RETURN    CSSMCLI    CL_FreeFields
       (CSSM_CL_HANDLE    CLHandle,    uint32     NumberOfFields,
       CSSM_FIELD_PTR *FieldArray)

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.  The length  of  the
       array  of  fields in FieldArray.  A pointer to an array of
       CSSM_FIELD structures that need to be deallocated.

DEFINITIONS    [Toc]    [Back]

       This function frees the fields in the FieldArray by  freeing
 the data pointers for both the FieldOid and FieldValue
       fields. It also frees the top level FieldArray pointer.

       This function should be used only to  free  CSSM_FIELD_PTR
       values  returned  from  calls  CSSM_TP_CertGetAllTemplateFields(),
              CSSM_CL_CertGetAllTemplateFields(),
       CSSM_CL_CertGetAllFields(),     CSSM_CL_CrlGetAllFields(),
       CSSM_CL_CrlGetAllCachedRecordFields(), or their SPI equivalent
 calls.

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).

       None specific to this call.

SEE ALSO    [Toc]    [Back]

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



                                                 CL_FreeFields(3)