CL_CertGetKeyInfo

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