task_set_name()

TASK_$SET_NAME                    Domain/OS                     TASK_$SET_NAME


NAME
     task_$set_name - name a task

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

     void task_$set_name(
          task_$handle_t task_handle,
          task_$name_pt name_pointer,
          long name_length,
          status_$t *status)

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

     procedure task_$set_name(
          in task_handle: task_$handle_t;
          in name_pointer: task_$name_pt;
          in name_length: integer32;
          out status: status_$t);

DESCRIPTION
     Task_$set_name associates the name pointed to by name_pointer with the
     task identified by task_handle. The name is copied into the task's infor-
     mation record, and is accessible via task_$get_info.

     task_handle
          A task handle.

     name_pointer
          A pointer to the name to be associated with the task.

     name_length
          The number of significant bytes at name_pointer.  Name_length should
          be task_$name_max_len or less.

     status
          The completion status.

SEE ALSO
     task_$create, task_$get_handle.
Museum
