TP_PassThrough(3)TP_PassThrough(3)NAME
TP_PassThrough, CSSM_TP_PassThrough - Extend trust policy functionality
SYNOPSIS
# 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 **Output‐
Params) SPI: CSSM_RETURN CSSMTPI TP_PassThrough (CSSM_TP_HANDLE TPHan‐
dle, CSSM_CL_HANDLE CLHandle, CSSM_CC_HANDLE CCHandle, const
CSSM_DL_DB_LIST *DBList, uint32 PassThroughId, const void *InputParams,
void **OutputParams)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
The handle that describes the add-in trust policy module used to per‐
form this function. The handle that describes the add-in certificate
library module that can be used to manipulate the subject certifi‐
cate 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 opera‐
tions, 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 secu‐
rity objects) that may be used by the pass-through 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 per‐
formed. A pointer to a module, implementation-specific structure con‐
taining parameters to be interpreted in a function-specific manner by
the requested TP module. A pointer to a module, implementation-spe‐
cific structure containing the output data. The service provider allo‐
cates the memory for substructures. The application must free the mem‐
ory for the substructures.
DESCRIPTION
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
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3). CSSMERR_TP_INVALID_CL_HANDLE CSSMERR_TP_INVALID_CON‐
TEXT_HANDLE CSSMERR_TP_INVALID_DL_HANDLE CSSMERR_TP_INVALID_DB_HANDLE
CSSMERR_TP_INVALID_DB_LIST_POINTER CSSMERR_TP_INVALID_DB_LIST CSS‐
MERR_TP_INVALID_PASSTHROUGH_ID
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
TP_PassThrough(3)