CSSM_CSP_CreatePassThroughContext

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