NAME    [Toc]    [Back]

       PassThrough,   CSSM_CSP_PassThrough,   CSP_PassThrough   -
       Extend crypto functionality (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI      CSSM_CSP_PassThrough
       (CSSM_CC_HANDLE CCHandle, uint32 PassThroughId, const void
       *InData,  void  **OutData)   SPI:   CSSM_RETURN   CSSMCSPI
       CSP_PassThrough (CSSM_CSP_HANDLE CSPHandle, CSSM_CC_HANDLE
       CCHandle,    const    CSSM_CONTEXT    *Context,     uint32
       PassThroughId, const void *InData, void **OutData)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

API PARAMETERS    [Toc]    [Back]

       The  handle  that  describes  the  context of this cryptographic
 operation.  An identifier  specifying  the  custom
       function  to  be performed.  A pointer to a module, implementation-specific
 structure containing the input data.  A
       pointer  to  a  module,  implementation-specific structure
       containing the output  data.  The  service  provider  will
       allocate  the  memory for this structure.  The application
       should free the memory for the structure.

SPI PARAMETERS    [Toc]    [Back]

       Handle of the CSP  supporting  the  PassThrough  function.
       Pointer  to  CSSM_CONTEXT  structure  that  describes  the
       attributes with this custom context structure.

DESCRIPTION    [Toc]    [Back]

       The     CSSM_CSP_PassThrough()     (CSSM     API),      or
       CSP_PassThrough() (CSP SPI), function is provided to allow
       CSP developers to extend the crypto functionality  of  the
       CSSM API.

NOTES    [Toc]    [Back]

       The CSP_EventNotify() function is used by the CSSM Core to
       interact with the CSP module.

       Because this function is only exposed to CSSM as  a  function
 pointer, the function name internal to the CSP can be
       assigned at the discretion of the  CSP  module  developer.
       However,  the  parameter  list and return value types must
       match those defined for this function.

       The error codes  given  in  this  section  constitute  the
       generic  error  codes,  which  may  be  used  by  all  CSP
       libraries to describe common error conditions.  CSP module
       developers may also define their own module-specific error
       codes.

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).  CSSMERR_CSP_INVALID_PASSTHROUGH_ID

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]




                                                   PassThrough(3)