CryptoAPI System Architecture

The CryptoAPI system architecture is composed of five major functional areas:

Base Cryptographic Functions

Certificate Encode/Decode Functions

Certificate Store Functions

Simplified Message Functions

  • Functions used to encrypt and decrypt messages and data.
  • Functions used to sign messages and data.
  • Functions used to verify the authenticity of signatures on received messages and related data.

For more information, see Simplified Messages and Simplified Message Functions.

Low-level Message Functions

  • Functions used to perform all of the tasks performed by the simplified message functions. The low-level message functions provide more flexibility than the simplified message functions but require more function calls. For more information, see Low-level Messages and Low-level Message Functions.

CryptoAPI architecture

Each of the functional areas has a key word in its function name that indicates its functional area.

Functional areaFunction name convention
Base cryptographic functionsCrypt
Encoding/decoding functionsCrypt
Certificate store functionsStore
Simplified message functionsMessage
Low-level message functionsMsg


Applications use functions in all of these areas. These functions, taken together, make up CryptoAPI. The base cryptographic functions use the CSPs for the necessary cryptographic algorithms and for the generation and secure storage of cryptographic keys.

Two different kinds of cryptographic keys are used: session keys, which are used for a single encryption/decryption, and public/private key pairs, which are used on a more permanent basis.

Note  Although an application can communicate directly with any of the five functional areas, it cannot communicate directly with a CSP. All application-to-CSP communications occur through the base cryptographic functions. Base cryptographic functions have a parameter that specifies which CSP to use. This parameter can be set to NULL to select a default CSP.