.. _eccpgetorderbitsize:


ECCPGetOrderBitSize
===================


Retrieves order size of the elliptic curve base point over GF(p) in
bits.


Syntax
------


IppStatus ippsECCPGetOrderBitSize(int\* pBitSize, IppsECCPState\* pECC);


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


``ippcp.h``


Parameters
----------


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

   * - pBitSize   
     - Pointer to the size of the base point (in bits).
   * - pECC   
     - Pointer to the cryptosystem context.




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


The function retrieves the order size (in bits) of the elliptic curve
base point *G* from the context of elliptic cryptosystem over a prime
finite field GF(*p*) and allocates it in accordance with the pointer
pBitsSize. 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 the cryptosystem contextis not valid.