CSSM_ChangeKeyOwner(3)CSSM_ChangeKeyOwner(3)NAMECSSM_ChangeKeyOwner - Change the owner of a key (CDSA)
SYNOPSIS
# 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
Common Security Services Manager library (libcssm.so)
PARAMETERS
The module handle that identifies the cryptographic service provider to
perform this operation. A pointer to the set of one or more creden‐
tials 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 val‐
ues 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
This function takes a CSSM_ACL_OWNER_PROTOTYPE defining the new owner
of the key.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3).
None specific to this call.
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions: CSSM_GetKeyOwner(3)CSSM_ChangeKeyOwner(3)