CL_CertGetKeyInfo(3)CL_CertGetKeyInfo(3)NAME
CL_CertGetKeyInfo, CSSM_CL_CertGetKeyInfo - Return the public key and
integral information (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_CL_CertGetKeyInfo (CSSM_CL_HANDLE CLHan‐
dle, const CSSM_DATA *Cert, CSSM_KEY_PTR *Key) SPI: CSSM_RETURN CSSMCLI
CL_CertGetKeyInfo (CSSM_CL_HANDLE CLHandle, const CSSM_DATA *Cert,
CSSM_KEY_PTR *Key)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
The handle that describes the add-in certificate library module used to
perform this function. A pointer to the CSSM_DATA structure containing
the certificate from which to extract the public key information. A
pointer to the CSSM_KEY structure containing the public key and possi‐
bly other key information. The CSSM_KEY structure and its substructures
are allocated by the service provider and must be deallocated by the
application.
DESCRIPTION
This function returns the public key and integral information about the
key from the specified certificate. The key structure returned is a
compound object. It can be used in any function requiring a key, such
as creating a cryptographic context.
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_CERT_POINTER CSSMERR_CL_UNKNOWN_FOR‐
MAT
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions for the CSSM API:
CSSM_CL_CertGetFirstFieldValue(3), CSSM_CL_FreeFieldValue(3)
Functions for the CLI SPI:
CL_CertGetFirstFieldValue(3), CL_FreeFieldValue(3)CL_CertGetKeyInfo(3)