NAME    [Toc]    [Back]

       CL_IsCertInCrl,  CSSM_CL_IsCertInCrl  -  Search  CRL for a
       certificate record (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_CL_IsCertInCrl (CSSM_CL_HANDLE
 CLHandle, const CSSM_DATA *Cert, const CSSM_DATA *Crl,
       CSSM_BOOL *CertFound) SPI: CSSM_RETURN CSSMCLI  CL_IsCertInCrl
  (CSSM_CL_HANDLE  CLHandle,  const  CSSM_DATA *Cert,
       const CSSM_DATA *Crl, CSSM_BOOL *CertFound)

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.  A pointer to the
       CSSM_DATA  structure  containing  the  certificate  to  be
       located.   A pointer to the CSSM_DATA structure containing
       the CRL to be searched.  A pointer to a CSSM_BOOL indicating
  success  or failure in finding the specified certificate
 in the CRL. CSSM_TRUE signifies that the  certificate
       was  found  in the CRL. CSSM_FALSE indicates that the certificate
 was not found in the CRL.

DESCRIPTION    [Toc]    [Back]

       This function searches the CRL for a record  corresponding
       to  the certificate.  The result of the search is returned
       in CertFound. The CRL and the records within the CRL  must
       be  digitally signed. This function does not verify either
       signature. The caller should  use  CSSM_TP_CrlVerify()  or
       CSSM_CL_CrlVerify()  (or  their  SPI  equivalents)  before
       invoking this function. Once the CRL  has  been  verified,
       the  caller  can  invoke  this function repeatedly without
       repeating the verification process.

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_CERT_POINTER    CSSMERR_CL_INVALID_CRL_POINTER
 CSSMERR_CL_UNKNOWN_FORMAT

SEE ALSO    [Toc]    [Back]

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



                                                CL_IsCertInCrl(3)