.. _eccpaddpoint:


ECCPAddPoint
============


Computes the addition of two elliptic curve points over GF(p).


Syntax
------


IppStatus ippsECCPAddPoint(const IppsECCPPointState\* pP, const
IppsECCPPointState\* pQ, IppsECCPPointState\* pR, IppsECCPState\* pECC);


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


ippcp.h


Parameters
----------


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

   * - pP   
     - Pointer to the elliptic curve point *P*.
   * - pQ   
     - Pointer to the elliptic curve point *Q*.
   * - pR   
     - Pointer to the elliptic curve point *R*.
   * - pECC   
     - Pointer to the context of the elliptic cryptosystem.




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


The function calculates the addition of two elliptic curve points ``P``
and ``Q`` over a finite field GF(*p*) with the result in a point ``R``
such that ``R = P + Q``.


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