CL_IsCertInCrl

NAME

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

SYNOPSIS

  # include <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

  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
          to be located.

  Crl (input)
          A pointer to the CSSM_DATA structure containing the CRL to be
          searched.

  CertFound (output)
          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

  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

  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_INVALID_CRL_POINTER
       CSSMERR_CL_UNKNOWN_FORMAT

SEE ALSO

  Intel CDSA Application Developer's Guide (see CDSA)