VMS Help  —  CDSA  CDSA_API, 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)
Close Help