CL_PassThrough

NAME

  CL_PassThrough,
  CSSM_CL_PassThrough - Extend certificate library functionality (CDSA)

SYNOPSIS

  # include <cssm.h>

   API:
       CSSM_RETURN CSSMAPI CSSM_CL_PassThrough
       (CSSM_CL_HANDLE CLHandle,
       CSSM_CC_HANDLE CCHandle,
       uint32 PassThroughId,
       const void *InputParams,
       void **OutputParams)

   SPI:
       CSSM_RETURN CSSMCLI CL_PassThrough
       (CSSM_CL_HANDLE CLHandle,
       CSSM_CC_HANDLE CCHandle,
       uint32 PassThroughId,
       const void *InputParams,
       void **OutputParams)

LIBRARY

  Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

PARAMETERS

  CLHandle (input)
          The handle that describes the add-in Certificate Library module
          used to perform this function.

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

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

  InputParams (input/optional)
          A pointer to a module, implementation-specific structure
          containing parameters to be interpreted in a function-specific
          manner by the requested CL module.

  OutputParams (output/optional)
          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

  This function allows applications to call certificate library module-
  specific operations. Such operations might include queries or services
  that are specific to the domain represented by the CL 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.

       CSSMERR_CL_INVALID_CONTEXT_HANDLE
       CSSMERR_CL_INVALID_PASSTHROUGH_ID
       CSSMERR_CL_INVALID_DATA

SEE ALSO

  Intel CDSA Application Developer's Guide (see CDSA)