ECCPComparePoint

Compares two points on the elliptic curve defined over GF(p).

Syntax

IppStatus ippsECCPComparePoint(const IppsECCPPointState* pP, const IppsECCPPointState* pQ, IppECResult* pResult, IppsECCPState* pECC);

Include Files

ippcp.h

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

The function compares two points P and Q on the elliptic curve defined over a prime finite field GF(p) 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: ECCPSet or ECCPSetStd.

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.