NAME
CSSM_CSP_CreateAsymmetricContext — Create an asymmetric encryption cryptographic context (CDSA)
SYNOPSIS
# include <cssm.h>
CSSM_RETURN CSSMAPI CSSM_CSP_CreateAsymmetricContext
(CSSM_CSP_HANDLE CSPHandle,
CSSM_ALGORITHMS AlgorithmID,
const CSSM_ACCESS_CREDENTIALS *AccessCred,
const CSSM_KEY *Key,
CSSM_PADDING Padding,
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. |
| AlgorithmID (input) |
| | | The algorithm identification number for the algorithm
used for asymmetric encryption. |
| AccessCred (input) |
| | | A pointer to the set of one or more credentials
required to unlock the private key. The credentials structure can
contain an immediate value for the credential, such as a passphrase,
or the caller can specify a callback function
the CSP can use to obtain one or more credentials. Credentials can
be required for encryption and decryption operations. |
| Key (input) | | The key used for asymmetric encryption. The caller
passes a pointer to a CSSM_KEY structure containing the key. When
the context is used for a sign operation, AccessCredentials is
required to access the private key used for signing. When the context
is used for a verify operation, the public key is used to verify
the signature. When the context is used for a wrapkey operation,
the public key can be used as the wrapping key. When the context
is used for an unwrap operation, AccessCredentials is
required to access the private key used to perform the unwrapping. |
| Padding (input/optional) |
| | | The method for padding. Typically specified for
ciphers that pad. |
| NewContextHandle (output) |
| | | Cryptographic context handle. |
DESCRIPTION
This function creates an asymmetric encryption cryptographic
context, given a handle of a CSP, an algorithm identification number,
a key, and padding. The cryptographic context handle is returned.
The cryptographic context handle can be used to call asymmetric
encryption functions and cryptographic wrap or unwrap functions.
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_DecryptData, CSSM_DecryptDataInit, CSSM_DecryptDataUpdate, CSSM_DecryptDataFinal, CSSM_DeleteContext, CSSM_EncryptData, CSSM_EncryptDataInit, CSSM_EncryptDataUpdate, CSSM_EncryptDataFinal, CSSM_GetContext, CSSM_GetContextAttribute, CSSM_QuerySize, CSSM_SetContext, CSSM_UpdateContextAttributes
