IecTaskCreate2 (FUN)

FUNCTION IecTaskCreate2 : RTS_IEC_HANDLE

Create a new IEC Task with taskgroup If the taskgroup does not exist or is no IEC taskgroup, the function returns ERR_PARAMETER. See IecTaskCreate for more details. Error code:

  • ERR_OK: The new task was successfully created.

  • ERR_FAILED: There was an error in a subsystem (e.g. the scheduler could not allocate his task handle).

  • ERR_PARAMETER: Invalid application- or task info pointer, unknown IEC taskgroup

  • ERR_OUT_OF_LIMITS: Maximum number of Tasks reached (target specific)

  • ERR_NOMEMORY: Unable to allocate the memory, that is necessary for the task description

InOut:

Scope

Name

Type

Comment

Return

IecTaskCreate2

RTS_IEC_HANDLE

Handle to newly created task

Input

pApp

POINTER TO APPLICATION

Pointer to application that contains the task

pTaskInfo

POINTER TO Task_Info2

Pointer to task information

psTaskGroup

REFERENCE TO STRING

Name of existing taskgroup

pResult

POINTER TO RTS_IEC_RESULT

Pointer to error code