Index for Section 3

Alphabetical listing for C

Bottom of page

CSSM_CSP_CreateAsymmetricContext(3)
NAME
  CSSM_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
  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 (see CDSA_intro(3))

  Reference Pages

  Functions: CSSM_DecryptData(3), CSSM_DecryptDataInit(3),
  CSSM_DecryptDataUpdate(3), CSSM_DecryptDataFinal(3), CSSM_DeleteContext(3),
  CSSM_EncryptData(3), CSSM_EncryptDataInit(3), CSSM_EncryptDataUpdate(3),
  CSSM_EncryptDataFinal(3), CSSM_GetContext(3), CSSM_GetContextAttribute(3),
  CSSM_QuerySize(3), CSSM_SetContext(3), CSSM_UpdateContextAttributes(3)

Index for Section 3

Alphabetical listing for C

Top of page