ECCPGet

Retrieves elliptic curve domain parameters over GF(p).

Syntax

IppStatus ippsECCPGet(IppsBigNumState* pPrime, IppsBigNumState* pA, IppsBigNumState* pB, IppsBigNumState* pGX,IppsBigNumState* pGY, IppsBigNumState* pOrder, int* cofactor, IppsECCPState* pECC);

Include Files

ippcp.h

Parameters

pPrime

Pointer to the characteristic p of the prime finite field GF(p).

pA

Pointer to the coefficient A of the equation defining the elliptic curve.

pB

Pointer to the coefficient B of the equation defining the elliptic curve.

pGX

Pointer to the x-coordinate of the elliptic curve base point.

pGY

Pointer to the y-coordinate of the elliptic curve base point.

pOrder

Pointer to the order n of the elliptic curve base point.

cofactor

Pointer to the cofactor h.

pECC

Pointer to the context of the cryptosystem.

Description

The function retrieves elliptic curve domain parameters from the context of the elliptic cryptosystem over a finite field GF(p) and allocates them in accordance with the pointers pPrime, pA, pB, pGX, pGY, pOrder, and cofactor. 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 pPrime, pA, pB, pGX, pGY, pOrder, or pECC is not valid.

ippStsRangeErr

Indicates an error condition if the memory size of one of the parameters pointed by pPrime, pA, pB, pGX, pGY, pOrder, and pECC is less than the value of feBitSize in the ECCPInit function.