.. _eccpmulpointscalar:



ECCPMulPointScalar
==================


Performs scalar multiplication of a point on the elliptic curve defined
over GF(p).


Syntax
------


IppStatus ippsECCPMulPointScalar(const IppsECCPPointState\* pP, const
IppsBigNumState\* pK, IppsECCPPointState\* pR, IppsECCPState\* pECC);


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


``ippcp.h``


Parameters
----------


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

   * - pP   
     - Pointer to the elliptic curve point ``P``.
   * - pK   
     - Pointer to the scalar ``K``.
   * - pR   
     - Pointer to the elliptic curve point ``R``.
   * - pECC   
     - Pointer to the context of the elliptic cryptosystem.




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


The function performs the ``K`` scalar multiplication of an elliptic
curve point ``P`` over GF(*p*) with the result in a point ``R`` such
that ``R = K``\ · ``P``.


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