NAME    [Toc]    [Back]

       EncryptDataInit, CSSM_EncryptDataInit, CSP_EncryptDataInit
       - Initialize the staged encrypt funciton (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI      CSSM_EncryptDataInit
       (CSSM_CC_HANDLE   CCHandle)   SPI:   CSSM_RETURN  CSSMCSPI
       CSP_EncryptDataInit      (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 encrypt function.
       There may be algorithm-specific and  token-specific  rules
       restricting  the  lengths  of  data  following data update
       calls making use of these parameters.

       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_QuerySize(3),   CSSM_DecryptData(3),    CSSM_EncryptDataInit(3),  CSSM_EncryptDataUpdate(3), CSSM_EncryptDataFinal(3), CSSM_EncryptDataP(3),  CSSM_EncryptDataInitP(3),
       CSSM_DecryptP(3), CSSM_DecryptDataInitP(3)

       Functions for the CSP SPI:

       CSP_QuerySize(3),     CSP_DecryptData(3),     CSP_EncryptDataInit(3), CSP_EncryptDataUpdate(3),  CSP_EncryptDataFinal(3)



                                               EncryptDataInit(3)