NAME    [Toc]    [Back]

       CSSM_ChangeKeyOwner - Change the owner of a key (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN  CSSMAPI  CSSM_ChangeKeyOwner (CSSM_CSP_HANDLE
       CSPHandle,  const   CSSM_ACCESS_CREDENTIALS   *AccessCred,
       const   CSSM_KEY   *Key,   const  CSSM_ACL_OWNER_PROTOTYPE
       *NewOwner)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The module handle that identifies the  cryptographic  service
 provider to perform this operation.  A pointer to the
       set of one or more credentials used to prove the caller is
       the  current  Oowner  of the key. Required credentials can
       include zero or more certificates,  zero  or  more  caller
       names,  and  one  or more samples.  If certificates and/or
       caller names are provided as input, these must be provided
       as  immediate values in this structure. The samples can be
       provided as immediate values or can be obtained through  a
       callback function included in the AccessCred structure.  A
       pointer to  the  target  key  whose  associated  Owner  is
       changed.   A  CSSM_ACL_OWNER_PROTOTYPE  defining  the  new
       owner of the key.

DESCRIPTION    [Toc]    [Back]

       This function takes  a  CSSM_ACL_OWNER_PROTOTYPE  defining
       the new owner of the key.

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).

       None specific to this call.

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions: CSSM_GetKeyOwner(3)



                                           CSSM_ChangeKeyOwner(3)