AC_PassThrough(3)AC_PassThrough(3)NAME
AC_PassThrough, CSSM_AC_PassThrough - Call exported module-specific
operations (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_AC_PassThrough (CSSM_AC_HANDLE ACHandle,
CSSM_TP_HANDLE TPHandle, CSSM_CL_HANDLE CLHandle, CSSM_CC_HANDLE CCHan‐
dle, const CSSM_DL_DB_LIST *DBList, uint32 PassThroughId, const void
*InputParams, void **OutputParams)
SPI: CSSM_RETURN CSSMACI AC_PassThrough (CSSM_AC_HANDLE ACHandle,
CSSM_TP_HANDLE TPHandle, CSSM_CL_HANDLE CLHandle, CSSM_CC_HANDLE CCHan‐
dle, 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 authorization computation module used to
perform this function. The handle that describes the trust policy mod‐
ule that can be used by the authorization computation service to imple‐
ment this function. If no trust policy module is specified, the AC mod‐
ule uses an assumed TP module, if required. 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 AC module uses an assumed CL module,
if required. The handle that describes the cryptographic context con‐
taining a handle that describes the add-in cryptographic service
provider module that can be used to perform cryptographic operations as
required to perform the requested operation. If no cryptographic con‐
text is specified, the AC module uses an assumed cryptographic context
and CSP module, if required. A list of handle pairs specifying a data
storage library module and a data store managed by that module. These
data stores can contain certificates, CRLs, and policy objects for use
by the AC module. If no DL and DB handle pairs are specified, the AC
module uses an assumed DL module and an assumed data store for this
operation. An identifier assigned by the AC module to indicate the
exported function to perform. A pointer to a module, implementation-
specific structure containing parameters to be interpreted in a func‐
tion-specific manner by the requested AC module. If the passthrough
function requires access to a private key located in the CSP referenced
by CSPHandle, then InputParams should contain a passphrase, or a call‐
back or cryptographic context that can be used to obtain the
passphrase. A pointer to a module, implementation-specific structure
containing the output data. The service provider will allocate the mem‐
ory for this structure. The application must free the memory for the
structure.
DESCRIPTION
This function allows applications to call authorization computation
module-specific operations that have been exported. Such operations
might include queries or services specific to the domain represented by
the AC 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_AC_INVALID_CL_HANDLE CSSMERR_AC_INVALID_CON‐
TEXT_HANDLE CSSMERR_AC_INVALID_DBLIST_POINTER CSS‐
MERR_AC_INVALID_DB_LIST CSSMERR_AC_INVALID_DB_HANDLE CSS‐
MERR_AC_INVALID_DL_HANDLE CSSMERR_AC_INVALID_PASSTHROUGH_ID CSS‐
MERR_AC_INVALID_TP_HANDLE
SEE ALSO
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
AC_PassThrough(3)