NAME    [Toc]    [Back]

       CL_CertVerifyWithKey,  CSSM_CL_CertVerifyWithKey  - Verify
       with a key (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:   CSSM_RETURN    CSSMAPI    CSSM_CL_CertVerifyWithKey
       (CSSM_CL_HANDLE  CLHandle,  CSSM_CC_HANDLE CCHandle, const
       CSSM_DATA *CertToBeVerified)

       SPI:     CSSM_RETURN     CSSMCLI      CL_CertVerifyWithKey
       (CSSM_CL_HANDLE  CLHandle,  CSSM_CC_HANDLE CCHandle, const
       CSSM_DATA *CertToBeVerified)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the certificate library  service
       module used to perform this function.  A signature verification
 context defining the CSP,  verification  algorithm,
       and public key that must be used to perform the operation.
       A signed certificate whose signature is to be verified.

DESCRIPTION    [Toc]    [Back]

       This function verifies that the CertToBeVerified parameter
       was  signed using a specific private key and that the certificate
 has not been altered since it  was  signed  using
       that private key. The public key corresponding to the private
 signing key is used in the verification process.

       The CCHandle, must be  a  signature  verification  context
       created  using  the  function CSSM_CSP_CreateSignatureContext()
 (CSSM API), or CSP_CreateSignatureContext()  (SPI).
       The   context  must  specify  the  Cryptographic  Services
       Provider (CSP) module, the verification algorithm, and the
       public  verification key that must be used to perform this
       operation.

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_CONTEXT_HANDLE   CSSMERR_CL_INVALID_CERT_POINTER
     CSSMERR_CL_UNKNOWN_FORMAT
       CSSMERR_CL_VERIFICATION_FAILURE

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_CertVerify(3), CSSM_CL_CrlVerify(3)

       Functions for the CLI SPI:

       CL_CertVerify(3), CL_CrlVerify(3)



                                          CL_CertVerifyWithKey(3)