NAME    [Toc]    [Back]

       CL_CrlSetFields, CSSM_CL_CrlSetFields - Set new field values
 (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI      CSSM_CL_CrlSetFields
       (CSSM_CL_HANDLE  CLHandle,  uint32  NumberOfFields,  const
       CSSM_FIELD   *CrlTemplate,   const   CSSM_DATA    *OldCrl,
       CSSM_DATA_PTR   ModifiedCrl)   SPI:   CSSM_RETURN  CSSMCLI
       CL_CrlSetFields  (CSSM_CL_HANDLE  CLHandle,  uint32   NumberOfFields,
    const   CSSM_FIELD   *CrlTemplate,   const
       CSSM_DATA *OldCrl, CSSM_DATA_PTR ModifiedCrl)

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 number of OID
       value pairs specified in the CrlTemplate input  parameter.
       Any  array  of field OID value pairs containing the values
       to initialize the CRL attribute fields.   The  CRL  to  be
       updated  with  the  new  attribute values. The CRL must be
       unsigned and available for update.  A pointer to the modified,
  unsigned CRL. The ModifiedCrl->Data is allocated by
       the service provider and must be deallocated by the application.

DESCRIPTION    [Toc]    [Back]

       This  function will set the fields of the input CRL to the
       new values, specified by the  input  OID/value  pairs.  If
       there  is  more  than one possible instance of an OID (for
       example, as in an extension or CRL  record),  then  a  new
       field with the specified value is added to the CRL.

       This  function  should  be  used  to update any of the CRL
       field values.  If a specified  field  was  initialized  by
       CSSM_CL_CrlCreateTemplate()   (CSSM  API),  or  CL_CrlCreateTemplate()
 (CL SPI), the field value is set to the  new
       specified  value. If a specified field was not initialized
       by the CSSM_CL_CrlCreateTemplate() (CSSM API), or  CL_CrlCreateTemplate()
  (CL  SPI),  the  field is set to the new
       specified value. The OldCrl must be unsigned.  Once a  CRL
       has  been  signed  using  CSSM_CL_CrlSign() (CSSM API), or
       CL_CrlSign() (CL SPI), the signed CRL's field values  cannot
 be modified. Modification would invalidate the cryptographic
 signature of the CRL.

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_INVALID_FIELD_POINTER   CSSMERR_CL_UNKNOWN_TAG
    CSSMERR_CL_INVALID_NUMBER_OF_FIELDS
       CSSMERR_CL_UNKNOWN_FORMAT   CSSMERR_CL_INVALID_CRL_POINTER
       CSSMERR_CL_CRL_ALREADY_SIGNED

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_CrlCreateTemplate(3),       CSSM_CL_CrlAddCert(3),
       CSSM_CL_CrlSign(3), CSSM_CL_CertGetFirstFieldValue(3)

       Functions for the CLI SPI:

       CL_CrlCreateTemplate(3), CL_CrlAddCert(3),  CL_CrlSign(3),
       CL_CertGetFirstFieldValue(3)



                                               CL_CrlSetFields(3)