NAME

   CSSM_CSP_ChangeLoginOwner - Define a new login owner (CDSA)

 SYNOPSIS

   # include <cssm.h>

        CSSM_RETURN CSSMAPI CSSM_CSP_ChangeLoginOwner
        (CSSM_CSP_HANDLE CSPHandle,
        const CSSM_ACCESS_CREDENTIALS *AccessCred,
        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 login owner. 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.

   NewOwner (Input)
           A CSSM_ACL_OWNER_PROTOTYPE defining the new login owner.

 DESCRIPTION

   This function takes a CSSM_ACL_OWNER_PROTOTYPE describing the new
   login owner.

 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_CSP_GetLoginOwner