CSSM_CSP_CreateAsymmetricContext(3)CSSM_CSP_CreateAsymmetricContext(3)NAMECSSM_CSP_CreateAsymmetricContext - Create an asymmetric encryption
cryptographic context (CDSA)
SYNOPSIS
# include <cdsa/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 (libcssm.so)
PARAMETERS
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. The algorithm identification number for the
algorithm used for asymmetric encryption. 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. The key used for asymmetric
encryption. The caller passes a pointer to a CSSM_KEY structure con‐
taining the key. When the context is used for a sign operation, Access‐
Credentials 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 opera‐
tion, 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. The method for
padding. Typically specified for ciphers that pad. Cryptographic con‐
text 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 crypto‐
graphic context handle can be used to call asymmetric encryption func‐
tions 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 repre‐
sent an error condition.
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions: CSSM_DecryptData(3), CSSM_DecryptDataInit(3), CSSM_Decrypt‐
DataUpdate(3), CSSM_DecryptDataFinal(3), CSSM_DeleteContext(3),
CSSM_EncryptData(3), CSSM_EncryptDataInit(3), CSSM_EncryptDataUp‐
date(3), CSSM_EncryptDataFinal(3), CSSM_GetContext(3), CSSM_GetContex‐
tAttribute(3), CSSM_QuerySize(3), CSSM_SetContext(3), CSSM_UpdateCon‐
textAttributes(3)CSSM_CSP_CreateAsymmetricContext(3)