F.55 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 Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide 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.

SEE ALSO

ctThrdInit and ctThrdExit.