CSSM_ChangeKeyOwner

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.  See CDSA.

  None specific to this call.

SEE ALSO
  Books

  Intel CDSA Application Developer's Guide (see CDSA)

  Other Help Topics

  Functions: CSSM_GetKeyOwner