summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/pr_queuejob_timer.rst
blob: 4460433fa580d7380a8cba91d12ec81d8e98fa35 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
PR_QueueJob_Timer
=================

Causes a job to be queued when a timer expires.


Syntax
------

.. code::

   #include <prtpool.h>

   NSPR_API(PRJob *)
   PR_QueueJob_Timer(
     PRThreadPool *tpool,
     PRIntervalTime timeout,
     PRJobFn fn,
     void * arg,
     PRBool joinable
   );


Parameters
~~~~~~~~~~

The function has the following parameters:

``tpool``
   A pointer to a :ref:`PRThreadPool` structure previously created by a
   call to :ref:`PR_CreateThreadPool`.
``iod``
   A pointer to a :ref:`PRJobIoDesc` structure.
``timeout``
   A value, expressed as a :ref:`PRIntervalTime`, to wait before queuing
   the job.
``fn``
   The function to be executed when the job is executed.
``arg``
   A pointer to an argument passed to ``fn``.
``joinable``
   If ``PR_TRUE``, the job is joinable. If ``PR_FALSE``, the job is not
   joinable. See :ref:`PR_JoinJob`.


Returns
~~~~~~~

Pointer to a :ref:`PRJob` structure or ``NULL`` on error.