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