.. _eccpsetpoint:

ECCPSetPoint
============


Sets coordinates of a point on the elliptic curve defined over GF(p).


Syntax
------


IppStatus ippsECCPSetPoint(const IppsBigNumState\* pX, const
IppsBigNumState\* pY, IppsECCPPointState\* pPoint, IppsECCPState\*
pECC);


Include Files
-------------


``ippcp.h``


Parameters
----------


.. list-table:: 
   :header-rows: 0

   * - pX   
     - Pointer to the *x*-coordinate of the point on the elliptic curve.
   * - pY   
     - Pointer to the *y*-coordinate of the point on the elliptic curve.
   * - pPoint   
     - Pointer to the context of the elliptic curve point.
   * - pECC   
     - Pointer to the context of the elliptic cryptosystem.




Description
-----------


The function sets the coordinates of a point on the elliptic curve
defined over a prime finite field GF(*p*).


The context of the point on the elliptic curve must be already created
by functions:
`ECCPPointGetSize <eccppointgetsize.html>`__
and
`ECCPPointInit <eccppointinit.html>`__.
The elliptic curve domain parameters must be hitherto defined by one of
the functions:
`ECCPSet <eccpset.html>`__
or
`ECCPSetStd <eccpsetstd.html>`__.


Return Values
-------------


.. list-table:: 
   :header-rows: 0

   * - 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 pX, pY, pPoint, or pECC is not valid.