CL_CertVerifyWithKey(3)CL_CertVerifyWithKey(3)NAME
CL_CertVerifyWithKey, CSSM_CL_CertVerifyWithKey - Verify with a key
(CDSA)
SYNOPSIS
# 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
Common Security Services Manager library (libcssm.so)
PARAMETERS
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
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 cor‐
responding 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_Cre‐
ateSignatureContext() (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
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3). CSSMERR_CL_INVALID_CONTEXT_HANDLE CSS‐
MERR_CL_INVALID_CERT_POINTER CSSMERR_CL_UNKNOWN_FORMAT CSSMERR_CL_VERI‐
FICATION_FAILURE
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
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)