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