Copyright Digital Equipment Corp. All rights reserved.

DecryptDataInitP

NAME
  DecryptDataInitP - Intialize the staged decrypt function with
                     privilege (CDSA)

SYNOPSIS
  # include <cssm.h>

       CSSM_RETURN CSSMAPI CSSM_DecryptDataInitP
       (CSSM_CC_HANDLE CCHandle,
       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_DecryptDataInit() for other parameters.

DESCRIPTION
  This function is similar to CSSM_DecryptDataInit().  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.

  For staged operations using privilege initialization functions
  CSSM_DecryptDataInitP(), the completion functions
  CSSM_DecryptDataUpdate() and CSSM_DecryptDataFinalize() are used.

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_DecryptData
      CSSM_EncryptDataInit
      CSSM_EncryptDataUpdate
      CSSM_EncryptDataFinal
      CSSM_EncryptDataP
      CSSM_EncryptDataInitP
      CSSM_DecryptP
      CSSM_DecryptDataInitP
      CSSM_QuerySize