ECCBSetKeyPair

Sets private and/or public keys in the elliptic cryptosystem over GF(2^m).

Syntax

IppStatus ippsECCBSetKeyPair(const IppsBigNumState* pPrivate, const IppsECCBPoint* pPublic, IppBool regular, IppsECCBState* pECC);

Parameters

pPrivate	Pointer to the private key `privKey`.
pPublic	Pointer to the public key `pubKey`.
regular	Key status flag.
pECC	Pointer to the context of the elliptic cryptosystem.

Description

This function is declared in the ippcp.h file.

The function sets the private key privKey and/or public key pubKey in the elliptic cryptosystem defined over a binary finite field GF(2^m).

The private key privKey is a number that lies in the range of [1, n-1] where n is the order of the elliptic curve base point. The public key pubKey is an elliptic curve point such that pubKey = privKey · G, where G is the base point of the elliptic curve.

The two possible values of the parameter regular define the key timeliness status:

ippTrue	Keys are regular.
ippFalse	Keys are ephemeral.

The elliptic curve domain parameters must be hitherto defined by one of the functions: ECCBSet or ECCBSetStd.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr	Indicates an error condition if any of the specified pointers is NULL.
ippStsContextMatchErr	Indicates an error condition if one of the contexts pointed by pPrivate, pPublic, or pECC is not valid.