.. _setnumthreads:


SetNumThreads
=============


Sets the number of threads in the multithreading environment.


Syntax
------


IppStatus ippcpSetNumThreads(int numThr);


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


``ippcp.h``


Parameters
----------


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

   * -     numThr   
     -  Number of threads, should be more than zero.




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


This function sets the number of OpenMP\* threads. A number of
established threads may be less than specified numThr.


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


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

   * -     ippStsNoErr   
     -  Indicates no error.
   * -     ippStsSizeErr   
     -  Indicates an error when numThr is less than, or equal to zero.
   * -     ippStsNoOperation   
     -  Indicates that the function is called from the application linked to the single-threaded version of the library. No operation is performed.