NAME    [Toc]    [Back]

       DecryptDataInit, CSSM_DecryptDataInit, CSP_DecryptDataInit
       - Initialize the staged decrypt function(CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI      CSSM_DecryptDataInit
       (CSSM_CC_HANDLE   CCHandle)   SPI:   CSSM_RETURN  CSSMCSPI
       CSSM_CSP_DecryptDataInit    (CSSM_CSP_HANDLE    CSPHandle,
       CSSM_CC_HANDLE   CCHandle,  const  CSSM_CONTEXT  *Context,
       CSSM_PRIVILEGE Privilege)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

API PARAMETERS    [Toc]    [Back]

       The handle that describes  the  context  of  this  cryptographic
 operation used to link to the CSP-managed information.

SPI PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in cryptographic service
       provider module used to perform calls to CSSM for the memory
 functions managed by CSSM.   Pointer  to  CSSM_CONTEXT
       structure that describes the attributes with this context.
       The export privilege to  be  applied  during  the  cryptographic
  operation. This parameter is forwarded to the CSP
       after CSSM verifies the caller and service provider privilege
 set includes the specified PRIVILEGE.

DESCRIPTION    [Toc]    [Back]

       This function initializes the staged decrypt function.

       The CSP can require that the cryptographic context include
       access credentials for  authentication  and  authorization
       checks when using a private key or a secret key.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).

       None specific to this call.

SEE ALSO    [Toc]    [Back]

       Books

       Intel   CDSA   Application    Developer's    Guide    (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_DecryptData(3),            CSSM_DecryptDataUpdate(3),
       CSSM_DecryptDataFinal(3),            CSSM_DecryptDataP(3),
       CSSM_DecryptDataInitP(3)

       Functions for the CSP SPI:

       CSP_DecryptData(3), CSP_DecryptDataUpdate(3), CSP_DecryptDataFinal(3)



                                               DecryptDataInit(3)