Index for Section 3

Alphabetical listing for A

Bottom of page

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 CCHandle,
       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 CCHandle,
       const CSSM_DL_DB_LIST *DBList,
       uint32 PassThroughId,
       const void *InputParams,
       void **OutputParams)

LIBRARY
  Common Security Services Manager library (libcssm.so)

PARAMETERS
  ACHandle (input)
	  The handle that describes the authorization computation module used
	  to perform this function.

  TPHandle (input/optional)
	  The handle that describes the trust policy module that can be used
	  by the authorization computation service to implement this
	  function. If no trust policy module is specified, the AC module
	  uses an assumed TP module, if required.

  CLHandle (input/optional)
	  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.

  CCHandle (input/optional)
	  The handle that describes the cryptographic context containing 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
	  context is specified, the AC module uses an assumed cryptographic
	  context and CSP module, if required.

  DBList (input/optional)
	  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.

  PassThroughId (input)
	  An identifier assigned by the AC module to indicate the exported
	  function to perform.

  InputParams (input)
	  A pointer to a module, implementation-specific structure containing
	  parameters to be interpreted in a function-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 callback or
	  cryptographic context that can be used to obtain the passphrase.

  OutputParams (output/optional)
	  A pointer to a module, implementation-specific structure containing
	  the output data. The service provider will allocate the memory 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 represent
  an error condition.

ERRORS
  Errors are described in the CDSA technical standard.	See CDSA_intro(3).

       CSSMERR_AC_INVALID_CL_HANDLE
       CSSMERR_AC_INVALID_CONTEXT_HANDLE
       CSSMERR_AC_INVALID_DBLIST_POINTER
       CSSMERR_AC_INVALID_DB_LIST
       CSSMERR_AC_INVALID_DB_HANDLE
       CSSMERR_AC_INVALID_DL_HANDLE
       CSSMERR_AC_INVALID_PASSTHROUGH_ID
       CSSMERR_AC_INVALID_TP_HANDLE

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

Index for Section 3

Alphabetical listing for A

Top of page