ctThrdSemapTry

Try once to get one unit of a semaphore.

Short Name

ctThrdSemapTry()

Type

Threading function

Declaration

NINT ctThrdSemapTry(pctSEMAP semap)

Description

Same as ctThrdSemapGet() except that if no unit of the semaphore is available, ctThrdSemapTry() returns NTIM_ERR (156).

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful function.
90	NQUE_ERR	Invalid qid.
156	NTIM_ERR	block in use by another thread. Timeout error.
514	CQUE_ERR	Queue could not be closed.
636	TSYF_ERR	block get failed.
638	TQUE_ERR	Queue message truncated to fit.

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

Limitations

Can only be used with a ctThrd library.