Posts the specified event.
call "CBL_EVENT_POST" using by value event-handle
| Using call prototype (see Key) | Picture | |
|---|---|---|
| event-handle | cblt-pointer | usage pointer. |
| event-handle | The event handle. |
| return-code | A value of 0 indicates that the call was successful. Any other value indicates an error. See RETURN-CODE Values For Synchronization Routines |
Comments:
If any threads are waiting for the event to be posted in the CBL_EVENT_WAIT call, they are all allowed to run and hence return from their CBL_EVENT_WAIT calls. The call has no effect if the event was already posted. The call returns zero for success.
Behavior is undefined if event-handle is invalid.