ECCBGet

Retrieves elliptic curve domain parameters over GF(2^m).

Syntax

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

Parameters

pPrime	Pointer to the irreducible binary polynomial f(x) of degree m which specifies the presentation of the field GF(2^m).
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

This function is declared in the ippcp.h file.

The function retrieves elliptic curve domain parameters from the context of the elliptic cryptosystem over a binary finite field GF(2^m) 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: 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 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 ECCBInit function.