CSSM_CSP_ChangeLoginOwner

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