ctThrdCreate

Create a c-tree Plus thread.

Short Name

ctThrdCreate()

Type

Threading function

Declaration

NINT ctThrdCreate(pctFUNC function, pVOID argument_list,

                  pVOID user_var, LONG mode)

Description

Create thread with entry point at function, arguments pointed to by argument_list, private thread data pointed to by user_var, and thread characteristics specified by mode, a bit-map where zero is the default. Currently, mode is ignored.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful function.
10	SPAC_ERR	Too much space required.
82	UALC_ERR	Not enough memory.
95	STSK_ERR	Could not start task.
600	CTHD_ERR	Ran out of fixed threads or could not get new thread.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.

Example

See ctmtex.c and ctmtap.c for ctThrdCreate() examples.

Limitations

Can only be used with a ctThrd library.