[ Version ( since = "6.0" ) ]
public bool set_callback (MainContext? context, WorkerCallback? callback) throws Error
Declare a callback function to be called when a job has been processed.
If callback is null, then any previously effect of this function is removed. If the same
function is called with a different callback value, then the previous one is simply replaced.
Since this function adds a new source of events to the specified MainContext (or the default one if
context is null),
Notes: <itemizedlist> <listitem><para>before calling this function, this internally
gets rid of the job, so the jib_id passed to callback does not actually designate a known job ID, and so
calling fetch_job_result for that job ID will fail</para><
/listitem> <listitem><para>the job's result, if any, has to be freed by callback (
this does not do it)</para></listitem> <listitem><para>any call to this function will only be honored
for the jobs submitted _after_ calling it, the ones submitted before are not affected</para></listitem> <listitem><
para>passing null for context is similar to passing the result of
ref_thread_default</para></listitem> </itemizedlist>
| this |
a Worker object |
| context |
a MainContext, or null |
| callback |
the function to call when a job submitted from within the calling thread using submit_job has finished being processed. |
| user_data |
argument passed to |
|
true if no error occurred. |