Developer Reference

Contents

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 key
privKey
.
pPublic
Pointer to the public key
pubKey
.
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 is
NULL
.
ippStsContextMatchErr
Indicates an error condition if one of the contexts pointed by
pPrivate
,
pPublic
, or
pECC
is not valid.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.