NAME    [Toc]    [Back]

       WrapKeyP - Wrap a key with privilege (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN  CSSMAPI  CSSM_WrapKeyP (CSSM_CC_HANDLE CCHandle,
  const  CSSM_ACCESS_CREDENTIALS  *AccessCred,   const
       CSSM_KEY    *Key,    const   CSSM_DATA   *DescriptiveData,
       CSSM_WRAP_KEY_PTR WrappedKey, 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_WrapKey(3).

DESCRIPTION    [Toc]    [Back]

       This  function  is  similar  to  CSSM_WrapKey().  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() functon, 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).

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]




                                                      WrapKeyP(3)