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)