ECCBComparePoint

Compares two points on the elliptic curve defined over GF(2^m).

Syntax

IppStatus ippsECCBComparePoint(const IppsECCBPoint* pP, const IppsECCBPoint* pQ, IppECResult* pResult, IppsECCBState* pECC);

Parameters

pP	Pointer to the elliptic curve point P.
pQ	Pointer to the elliptic curve point Q.
pResult	Pointer to the comparison result of two points: P and Q.
pECC	Pointer to the context of the elliptic cryptosystem.

Description

This function is declared in the ippcp.h file.

The function compares two points P and Q on the elliptic curve defined over a binary finite field GF(2^m) and allocates the comparison result in accordance with the pointer pResult.

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

The comparison result of two points P and Q can take one of the following values:

ippECPointIsEqual	Points P and Q are equal.
ippECPointIsNotEqual	Points P and Q are different.

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 pP or pECC is not valid.