NAME

   CL_CertGetKeyInfo,
   CSSM_CL_CertGetKeyInfo - Return the public key and integral
                            information (CDSA)

 SYNOPSIS

   # include <cssm.h>

        API:
        CSSM_RETURN CSSMAPI CSSM_CL_CertGetKeyInfo
        (CSSM_CL_HANDLE CLHandle,
        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 (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
           from which to extract the public key information.

   Key (output)
           A pointer to the CSSM_KEY structure containing the public key
           and possibly 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
   represent an error condition.

 ERRORS

   Errors are described in the CDSA technical standard.  See CDSA.

        CSSMERR_CL_INVALID_CERT_POINTER
        CSSMERR_CL_UNKNOWN_FORMAT

 SEE ALSO

   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions for the CSSM API:

       CSSM_CL_CertGetFirstFieldValue
       CSSM_CL_FreeFieldValue

   Functions for the CLI SPI:

       CL_CertGetFirstFieldValue
       CL_FreeFieldValue