NAME    [Toc]    [Back]

       CL_CertGetAllTemplateFields,   CSSM_CL_CertGetAllTemplateFields
 - Extract and return values stored in  CertTemplate
       (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:  CSSM_RETURN CSSMAPI CSSM_CL_CertGetAllTemplateFields
       (CSSM_CL_HANDLE CLHandle, const  CSSM_DATA  *CertTemplate,
       uint32  *NumberOfFields,  CSSM_FIELD_PTR *CertFields) SPI:
       CSSM_RETURN      CSSMCLI       CL_CertGetAllTemplateFields
       (CSSM_CL_HANDLE  CLHandle,  const CSSM_DATA *CertTemplate,
       uint32 *NumberOfFields, CSSM_FIELD_PTR *CertFields)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the certificate  library  module
       used to perform this function.  A pointer to the CSSM_DATA
       structure containing the packed, encoded certificate  template.
   The  length  of  the  output  array of fields.  A
       pointer to an array of CSSM_FIELD  structures  which  contains
  the OIDs and values of the fields of the input certificate
 template.

DESCRIPTION    [Toc]    [Back]

       This function extracts and returns a copy  of  the  values
       stored  in  the  encoded  CertTemplate. The memory for the
       CertFields output is allocated  by  the  service  provider
       using  the  calling  application's  memory management routines.
 The application must deallocate the memory by calling
  CSSM_CL_FreeFields()  (CSSM  API), or CL_FreeFields()
       (CL SPI).

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_FORMAT

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_CL_FreeFields(3), CSSM_CL_CertCreateTemplate(3)

       Functions for the CLI SPI:

       CL_FreeFields(3), CL_CertCreateTemplate(3)