GFpECTstPoint

Checks if a point belongs to an elliptic curve.

Syntax

IppStatus ippsGFpECTstPoint(const IppsGFpECPoint* pP, IppECResult* pResult, IppsGFpECState* pEC);

Include Files

ippcp.h

Parameters

pP

Pointer to the IppsGFpECPoint context.

pResult

Pointer to the result of the check.

pEC

Pointer to the context of the elliptic curve.

Description

This function checks whether the given point belongs to the elliptic curve over the finite field. The result of the testing is returned in pResult and may have the following values:

ippECValid

The point belongs to the curve.

ippECPointIsAtInfinite

The point is a point at infinity.

ippECPointIsNotValid

The point does not belong to the curve.

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 any of the specified contexts does not match the operation.

ippStsOutOfRangeErr

Indicates an error condition if the coordinates of the point pP do not belong to the finite field over which the elliptic curve is initialized.