NAME
CSSM_ChangeKeyOwner — Change the owner of a key (CDSA)
SYNOPSIS
# include <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 (cdsa$incssm300_shr.exe)
PARAMETERS
| CSPHandle (input) |
| | | The module handle that identifies the Cryptographic
Service Provider to perform this operation. |
| AccessCred (input) |
| | | 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. |
| Key (input) | | A pointer to the target key whose associated Owner
is changed. |
| NewOwner (Input) | | 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 represent an error condition.
ERRORS
Errors are described in the CDSA Technical Standard.
None specific to this call.
SEE ALSO
Books
Intel CDSA Application Developer's Guide
Online Help
Functions: CSSM_GetKeyOwner
