CSSM_CL_PassThrough

Purpose

This function allows applications to call CL module-specific operations. Such operations may include queries or services that are specific to the domain represented by the CL module.

Format

void * CSSMAPI CSSM_CL_PassThrough
                  (CSSM_CL_HANDLE CLHandle,
                  CSSM_CC_HANDLE CCHandle,
                  uint32 PassThroughId,
                  const void *InputParams)

Parameters

Input

CLHandle: The handle that describes the CL module used to perform this function.
PassThroughId: An identifier assigned by the CL module to indicate the exported function to perform.
InputParams: A pointer to a module, implementation-specific structures containing parameters to be interpreted in a function-specific manner by the requested CL module. This parameter can be used as a pointer to an array of CSSM_DATA structures.

Input/optional

CCHandle: 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.

Return Value

A pointer to a module, implementation-specific structure containing the output from the passthrough function. The output data must be interpreted by the calling application based on externally available information. If the pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.