ECCPSetKeyPair
ECCPSetKeyPair
Sets private and/or public keys of the elliptic cryptosystem over GF(p).
Syntax
IppStatus ippsECCPSetKeyPair(const IppsBigNumState*
pPrivate
, const IppsECCPPointState*
pPublic
, IppBool
regular
, IppsECCPState*
pECC
);
Include Files
ippcp.h
Parameters
- pPrivate
- Pointer to the private keyprivKey.
- pPublic
- Pointer to the public keypubKey.
- regular
- Key status flag.
- pECC
- Pointer to the context of the elliptic cryptosystem.
Description
The function sets a private key
privKey
and/or public key pubKey
in the elliptic cryptosystem defined over a prime finite field GF(p
). 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:
ECCPSet
or ECCPSetStd
.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 isNULL.
- ippStsContextMatchErr
- Indicates an error condition if one of the contexts pointed bypPrivate,pPublic, orpECCis not valid.