HELPLIB.HLB  —  CDSA  CDSA_API, 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
Close Help