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
Online Help
Functions: CSSM_CSP_PassThroughCSSM_GetContext, CSSM_SetContext, CSSM_DeleteContext, CSSM_GetContextAttribute, CSSM_UpdateContextAttributes
