TASK_$GET_EC                      Domain/OS                       TASK_$GET_EC


NAME
     task_$get_ec - get a completion eventcount

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

     void task_$get_ec(
          task_$handle_t task_handle,
          ec2_$ptr_t *eventcount_pointer,
          status_$t *status)

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

     procedure task_$get_ec(
          in task_handle: task_$handle_t;
          out eventcount_pointer: ec2_$ptr_t;
          out status: status_$t);

DESCRIPTION
     Task_$get_ec returns a pointer to the completion eventcount for the task
     identified by task_handle.  The task must have been created with a com-
     pletion eventcount; that is, the task_$create call that created it must
     have specified the task_$intend_to_wait option.

     task_handle
          The handle of the task, in task_$handle_t format.

     eventcount_pointer
          A pointer to an eventcount.

     status
          The completion status.

SEE ALSO
     ec2_$intro, task_$get_handle, task_$release, task_$set_result.