Museum

TASK_$GET_INFO                    Domain/OS                     TASK_$GET_INFO


NAME
     task_$get_info - get information about a task

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/task.h>

     void task_$get_info(
          task_$handle_t task_handle,
          task_$info_pt info_pointer,
          task_$handle_t *next_handle,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/task.ins.pas';

     procedure task_$get_info(
          in task_handle: task_$handle_t;
          in info_pointer: task_$info_pt;
          out next_handle: task_$handle_t;
          out status: status_$t);

DESCRIPTION
     Task_$get_info gets information about the task identified by task_handle.

     task_handle
          A task handle.

     info_pointer
          The task information.

     next_handle
          The handle of the next task for which information can be obtained.
          The handles for tasks in a process are in a circular list.  Repeated
          calls to task_$get_info with task_handle set to the next_handle sup-
          plied by the previous call will eventually return a next_handle
          equivalent to the task_handle when task_$get_info was first called,
          indicating that all tasks have been described.

     status
          The completion status.

SEE ALSO
     task_$create, task_$get_handle.