HELPLIB.HLB  —  CDSA  CDSA_API, CL CertGetAllFields
 NAME

   CL_CertGetAllFields,
   CSSM_CL_CertGetAllFields - Return a list of input certificate values
                              (CDSA)

 SYNOPSIS

   # include <cssm.h>

        API:
        CSSM_RETURN CSSMAPI CSSM_CL_CertGetAllFields
        (CSSM_CL_HANDLE CLHandle,
        const CSSM_DATA *Cert,
        uint32 *NumberOfFields,
        CSSM_FIELD_PTR *FieldList)
        SPI:
        CSSM_RETURN CSSMCLI CL_CertGetAllFields
        (CSSM_CL_HANDLE CLHandle,
        const CSSM_DATA *Cert,
        uint32 *NumberOfFields,
        CSSM_FIELD_PTR *FieldList)

 LIBRARY

   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 PARAMETERS

   CLHandle (input)
           The handle that describes the add-in certificate library module
           used to perform this function.

   Cert (input)
           A pointer to the CSSM_DATA structure containing the certificate
           whose fields will be returned.

   NumberOfFields (output)
           The length of the returned array of fields.

   FieldList (output)
           A pointer to an array of CSSM_FIELD structures that contain the
           values of all fields of the input certificate. The field list is
           allocated by the service provider and must be deallocated by the
           application by calling CSSM_CL_FreeFields() (CSSM API), or
           CL_FreeFields() (CL SPI).

 DESCRIPTION

   This function returns a list of the values stored in the input
   certificate.

 RETURN VALUE

   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

   Errors are described in the CDSA technical standard.  See CDSA.

        CSSMERR_CL_INVALID_CERT_POINTER
        CSSMERR_CL_UNKNOWN_FORMAT

 SEE ALSO

   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   For the CSSM API: CSSM_CL_CertGetFirstFieldValue,
                     CSSM_CL_CertDescribeFormat
                     CSSM_CL_FreeFields

   For the CLI SPI: CL_CertGetFirstFieldValue
                    CL_CertDescribeFormat
                    CL_FreeFields
Close Help