gsk_construct_public

Constructs a public key from its component values

Format

   #include <gskcms.h>

   gsk_status gsk_construct_public_key(
                                        gsk_public_key *           public_key_factors, 
                                        x509_public_key_info *     public_key)

Parameters

public_key_factors: Specifies the public key structure containing the key algorithm type and public key components.
public_key: Returns the public key.

Results

The function return value will be 0 if no error is detected. Otherwise, it will be one of the return codes listed in the gskcms.h include file. These are some possible errors:

[CMSERR_ALG_NOT_SUPPORTED]: Cryptographic algorithm not supported
[CMSERR_BASE_NOT_SUPPLIED]: Base not supplied
[CMSERR_EC_PARAMETERS_NOT_SUPPLIED]: EC parameters not supplied.
[CMSERR_MODULUS_NOT_SUPPLIED]: Modulus not supplied
[CMSERR_PRIME_NOT_SUPPLIED]: Prime not supplied
[CMSERR_PUBLIC_EXPONENT_NOT_SUPPLIED]: Public exponent not supplied
[CMSERR_PUBLIC_KEY_INFO_NOT_SUPPLIED]: Public key information not supplied
[CMSERR_PUBLIC_KEY_NOT_SUPPLIED]: Public key structure not supplied
[CMSERR_PUBLIC_VALUE_NOT_SUPPLIED]: Public value not supplied
[CMSERR_STRUCTURE_TOO_SMALL]: Size specified for supplied structure is too small
[CMSERR_SUB_PRIME_NOT_SUPPLIED]: Sub-prime not supplied

Usage

The gsk_construct_public_key() function constructs the x509_public_key_info from the supplied public key components. The format of the supplied components is as stored in ICSF PKCS #11 tokens.

Before calling the function, the application must initialize the size field in public_key_factors to the size of the gsk_public_key structure. It must also prime public_key_factors with the x509_algorithm_identifier, including appropriate public key components for the public key type being constructed.

The x509_algorithm_identifier in public_key is set with the appropriate value for the public key type when returned.