NAME    [Toc]    [Back]

       CL_CertDescribeFormat, CSSM_CL_CertDescribeFormat - Return
       a list of the CSSM_OID values (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:   CSSM_RETURN   CSSMAPI    CSSM_CL_CertDescribeFormat
       (CSSM_CL_HANDLE     CLHandle,     uint32    *NumberOfOids,
       CSSM_OID_PTR   *OidList)    SPI:    CSSM_RETURN    CSSMAPI
       CSSM_CL_CertDescribeFormat    (CSSM_CL_HANDLE    CLHandle,
       uint32 *NumberOfOids, CSSM_OID_PTR *OidList)

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
       returned array  of  OIDs.   A  pointer  to  the  array  of
       CSSM_OIDs that represent the supported certificate format.
       The OID list is allocated by the service provider and must
       be deallocated by the application.

DESCRIPTION    [Toc]    [Back]

       This  function  returns a list of the CSSM_OID values this
       certificate library module  uses  to  name  and  reference
       fields of a certificate. Multiple CSSM_OID values can correspond
 to a single field. These OIDs can be  provided  as
       input  to  CSSM_CL_CertGetFirstFieldValue() (CSSM API), or
       CL_CertGetFirstFieldValue() (CL SPI),  to  retrieve  field
       values from the certificate. The OID also implies the data
       format of the returned value. When multiple OIDs name  the
       same  field  of  a  certificate, those OIDs have different
       return data formats associated with them.

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]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_CL_CertGetAllFields(3),    CSSM_CL_CertGetFirstFieldValue(3), CSSM_CL_CertGetFirstCachedFieldValue(3)

       Functions for the CLI SPI:

       CL_CertGetAllFields(3),      CL_CertGetFirstFieldValue(3),
       CL_CertGetFirstCachedFieldValue(3)



                                         CL_CertDescribeFormat(3)