NAME

   CSSM_CSP_CreatePassThroughContext - Create a custom cryptographic
                                       context (CDSA)

 SYNOPSIS

   # include <cssm.h>

        CSSM_RETURN CSSMAPI CSSM_CSP_CreatePassThroughContext
        (CSSM_CSP_HANDLE CSPHandle,
        const CSSM_KEY *Key,
        CSSM_CC_HANDLE *NewContextHandle)

 LIBRARY

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

 PARAMETERS

   CSPHandle (input)
           The handle that describes the add-in cryptographic service
           provider module used to perform this function. If a NULL
           handle is specified, CSSM returns an error.

   Key (input)
           The key to be used for the context. The caller passes a
           pointer to a CSSM_KEY structure containing the key.

   NewContextHandle (output)
           Cryptographic context handle.

 DESCRIPTION

   This function creates a custom cryptographic context, given a handle
   of a CSP and a pointer to a custom input data structure. The
   cryptographic context handle is returned. The cryptographic context
   handle can be used to call the CSSM pass-through function for the CSP.

 NOTES

   A CSP can create its own set of custom functions. The context
   information can be passed through its own data structure.  The
   CSSM_CSP_PassThrough() function should be used with the function
   ID to call the desired custom function.

 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.

 SEE ALSO

   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions: CSSM_CSP_PassThrough
              CSSM_GetContext
              CSSM_SetContext
              CSSM_DeleteContext
              CSSM_GetContextAttribute
              CSSM_UpdateContextAttributes