Copyright Digital Equipment Corp. All rights reserved.

GenerateKeyP

NAME
  GenerateKeyP - Generate a key with privilege (CDSA)

SYNOPSIS
  # include <cssm.h>

       CSSM_RETURN CSSMAPI CSSM_GenerateKeyP
       (CSSM_CC_HANDLE CCHandle,
       uint32 KeyUsage,
       uint32 KeyAttr,
       const CSSM_DATA *KeyLabel,
       const CSSM_RESOURCE_CONTROL_CONTEXT *CredAndAclEntry,
       CSSM_KEY_PTR Key,
       CSSM_PRIVILEGE Privilege)

LIBRARY
  Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

PARAMETERS
  Privilege (input)
          The privilege to be applied during the cryptographic
          operation.

  See CSSM_GenerateKey for other parameters.

DESCRIPTION
  This function is similar to the CSSM_GenerateKey() function. It also
  accepts a USEE tag as a privilege request parameter. CSSM checks that
  either its own privilege set or the application's privilege set (if
  the application is signed) includes the tag. If the tag is found and
  the service provider privilege set indicates that it is supported,
  the tag is forwarded to the service provider.

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.

SEE ALSO
  Books

  Intel CDSA Application Developer's Guide (see CDSA)

  Other Help Topics

  Functions:

      CSSM_GenerateKeyPairP
      CSSM_GenerateRandom