NAME    [Toc]    [Back]

       TP_PassThrough,  CSSM_TP_PassThrough - Extend trust policy
       functionality

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_TP_PassThrough (CSSM_TP_HANDLE
   TPHandle,  CSSM_CL_HANDLE  CLHandle,  CSSM_CC_HANDLE
       CCHandle,   const    CSSM_DL_DB_LIST    *DBList,    uint32
       PassThroughId,  const  void  *InputParams,  void **OutputParams)
   SPI:    CSSM_RETURN    CSSMTPI    TP_PassThrough
       (CSSM_TP_HANDLE    TPHandle,    CSSM_CL_HANDLE   CLHandle,
       CSSM_CC_HANDLE CCHandle,  const  CSSM_DL_DB_LIST  *DBList,
       uint32 PassThroughId, const void *InputParams, void **OutputParams)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in trust  policy  module
       used  to perform this function.  The handle that describes
       the add-in certificate library  module       that  can  be
       used to manipulate the subject certificate and anchor certificates.
  If no certificate library module is specified,
       the TP module uses an assumed CL module, if required.  The
       handle that describes the  context  of  the  cryptographic
       operation.  If the module-specific operation does not perform
 any cryptographic operations, a cryptographic context
       is  not  required A list of handle pairs specifying a data
       storage library module and a data store, identifying  certificate
  databases  containing certificates (and possibly
       other security objects) that may  be  used  by  the  passthrough
  function. If no DL and DB handle pairs are specified,
 the TP module can use an assumed DL  module  and  an
       assumed  data  store  for  this  operation.  An identifier
       assigned by a TP module to indicate the exported  function
       to  be  performed.  A pointer to a module, implementationspecific
 structure containing parameters to be interpreted
       in  a function-specific manner by the requested TP module.
       A pointer to a module,  implementation-specific  structure
       containing the output data. The service provider allocates
       the memory for substructures. The  application  must  free
       the memory for the substructures.

DESCRIPTION    [Toc]    [Back]

       This  function  allows  applications  to call trust policy
       module-specific operations that have been  exported.  Such
       operations may include queries or services specific to the
       domain represented by the TP module.

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_TP_INVALID_CL_HANDLE     CSSMERR_TP_INVALID_CONTEXT_HANDLE
  CSSMERR_TP_INVALID_DL_HANDLE
            CSSMERR_TP_INVALID_DB_HANDLE           CSSMERR_TP_INVALID_DB_LIST_POINTER
 CSSMERR_TP_INVALID_DB_LIST
       CSSMERR_TP_INVALID_PASSTHROUGH_ID

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]




                                                TP_PassThrough(3)