.. _eccpinit:


ECCPInit
========


Initializes the context for the elliptic curve cryptosystem over GF(p).


Syntax
------


IppStatus ippsECCPInit(int feBitSize, IppsECCPState\* pECC);


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


``ippcp.h``


Parameters
----------


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

   * - feBitSize   
     - Size (in bits) of the underlying prime number.
   * - pECC   
     - Pointer to the cryptosystem context.




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


The function initializes the context of the elliptic curve cryptosystem
over the prime finite field GF(*p*).


*Context* is a structure IppsECCPState designed to store information
about the cryptosystem status.


.. note::


   For security reasons, the length of the underlying prime number is
   restricted to 1 kilobit.


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.
   * - ippStsSizeErr   
     - Indicates an error condition if the value of the parameter feBitSize is less than 2.
   * - ippStsLengthErr   
     - Indicates an error condition if the value of thefeBitsize parameter is less than 2 or greater than1024.


.. rubric:: Related Information

:ref:`data-security-considerations`