CSSM_DL_PassThrough

Purpose

This function allows applications to call data storage library module-specific operations that have been exported. Such operations may include queries or services that are specific to the domain represented by a DL module.

Format

void * CSSMAPI CSSM_DL_PassThrough (CSSM_DL_DB_HANDLE DLDBHandle,uint32 PassThroughId,
                                   const void *InputParams)

Parameters

Input

DLDBHandle: The handle pair that describes the data storage library module to be used to perform this function and the open data store upon which the function is to be performed.
PassThroughId: An identifier assigned by a DL module to indicate the exported function to be performed.
InputParams: A pointer to a module, implementation-specific structure containing parameters to be interpreted in a function-specific manner by the requested DL module. This parameter can be used as a pointer to an array of CSSM_DATA_PTRs.

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.