F.77 ctThrdSemapGet

---

Get one unit of a semaphore.

Short Name

ctThrdSemapGet

TYPE

Threading function

DECLARATION

NINT ctThrdSemapGet(pctSEMAP semap)

DESCRIPTION

Attempts to get one unit of the semaphore referenced by semap. The thread will block indefinitely until a unit of the semaphore is available.

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 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.

LIMITATIONS

Can only be used with a ctThrd library.

SEE ALSO

ctThrdSemapCls, ctThrdSemapInit, ctThrdSemapRel, and ctThrdSemapTry.