NAME    [Toc]    [Back]

       ObtainPrivateKeyFromPublicKey,         CSSM_CSP_ObtainPrivateKeyFromPublicKey,
 CSP_ObtainPrivateKeyFromPublicKey  -
       Convert public key to private key (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_CSP_ObtainPrivateKeyFromPublicKey
 (CSSM_CSP_HANDLE  CSPHandle  const  CSSM_KEY  *PublicKey,
 CSSM_KEY_PTR PrivateKey) SPI: CSSM_RETURN CSSMCSPI
       CSP_ObtainPrivateKeyFromPublicKey (CSSM_CSP_HANDLE CSPHandle,
 const CSSM_KEY *PublicKey, CSSM_KEY_PTR PrivateKey)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the module to perform this operation.
  The public key corresponding to  the  private  key
       being  sought.  A reference to the private key corresponding
 to the public key.

DESCRIPTION    [Toc]    [Back]

       Given a public key this function returns  a  reference  to
       the  private  key.  The  private  key  and  its associated
       passphrase can be used as an input to any function requiring
 a private key value.

NOTES    [Toc]    [Back]

       The  KeyData  field of the CSSM_KEY structure is allocated
       by the CSP. The application is required to free this  memory
  using the CSSM_FreeKey() (CSSM API), or CSP_FreeKey()
       (CSP SPI), function or with the  memory  functions  registered
 for the CSPHandle.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).  CSSMERR_CSP_PRIVATE_KEY_NOT_FOUND

SEE ALSO    [Toc]    [Back]

       Books

       Intel   CDSA   Application    Developer's    Guide    (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]




                                 ObtainPrivateKeyFromPublicKey(3)