skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 1:... HP Open Source Security for OpenVMS Volume 1:...
go to beginning of reference: API FunctionsAPI Functions
go to previous page: CL_CertVerifyCL_CertVerify
go to next page: CL_CrlAbortCacheCL_CrlAbortCache
end of book navigation links


CL_CertVerifyWithKey
Library
Description
Errors
 Parameters
Return Value
See Also

NAME

CL_CertVerifyWithKey: CSSM_CL_CertVerifyWithKey - Verify with a key (CDSA)

SYNOPSIS  

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


return to top LIBRARY  

Common Security Services Manager library (cdsa$incssm300_shr.exe)


return to top PARAMETERS  

CLHandle (input)
 The handle that describes the certificate libraryservice module used to perform this function.
CCHandle (input)
 A signature verification context defining the CSP,verification algorithm, and public key that must be used to performthe operation.
CertToBeVerified (input)
 A signed certificate whose signature is to be verified.


return to top DESCRIPTION  

This function verifies that the CertToBeVerified parameterwas signed using a specific private key and that the certificatehas not been altered since it was signed using that private key.The public key corresponding to the private signing key is usedin the verification process.

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


return to top RETURN VALUE  

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.


return to top ERRORS  

Errors are described in the CDSA Technical Standard.
CSSMERR_CL_INVALID_CONTEXT_HANDLECSSMERR_CL_INVALID_CERT_POINTERCSSMERR_CL_UNKNOWN_FORMATCSSMERR_CL_VERIFICATION_FAILURE


return to top SEE ALSO  

Books

Intel CDSA Application Developer's Guide

Online Help

Functions for the CSSM API:

CSSM_CL_CertVerify, CSSM_CL_CrlVerify

Functions for the CLI SPI:

CL_CertVerify, CL_CrlVerify


go to previous page: CL_CertVerifyCL_CertVerify
go to next page: CL_CrlAbortCacheCL_CrlAbortCache