NAME    [Toc]    [Back]

       UnwrapKeyP - Unwrap the wrapped keys with privilege (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN CSSMAPI CSSM_UnwrapKeyP (CSSM_CC_HANDLE CCHandle,
   const   CSSM_KEY  *PublicKey,  const  CSSM_WRAP_KEY
       *WrappedKey,  uint32  KeyUsage,  uint32   KeyAttr,   const
       CSSM_DATA  *KeyLabel,  const CSSM_RESOURCE_CONTROL_CONTEXT
       *CredAndAclEntry, CSSM_KEY_PTR UnwrappedKey, CSSM_DATA_PTR
       DescriptiveData, CSSM_PRIVILEGE Privilege)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The privilege to be applied during the cryptographic operation.


       See CSSM_UnwrapKey(3).

DESCRIPTION    [Toc]    [Back]

       This function is  similar  to  CSSM_UnwrapKey().  It  also
       accepts  a USEE tag as a privilege request parameter. CSSM
       checks that either its own privilege set or  the  Application's
  privilege  set  (if  the  Application  is  signed)
       includes the tag. If the tag  is  found  and  the  service
       provider privilege set indicates that it is supported, the
       tag is forwarded to the service provider.

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() 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_KEY_LABEL_ALREADY_EXISTS  CSSMERR_CSP_PUBLIC_KEY_INCONSISTENT
          CSSMERR_CSP_PRIVATE_KEY_ALREADY_EXIST

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]




                                                    UnwrapKeyP(3)