DosResetEventSem
From EDM2
Syntax
DosResetEventSem( hevSemaphore, pulPostCount )
Parameters
- HEV hevSemaphore (input)
- The handle of the semaphore to be reset.
- PUL pulPostCount (output)
- The post count of the semaphore that was reset. This can not be set to NULL, it must be a valid pointer to ULONG.
Returns
- APIRET rc
- The following values can be returned:
0 | NO_ERROR | Semaphore released successfully |
6 | ERROR_INVALID_HANDLE | Error, The value in phevSemaphore does not point to a valid semaphore, The calling process must first have access to the semaphore in question |
300 | ERROR_ALREADY_RESET | Error, The semaphore is already reset, no posts have occurred since last reset |
Usage Explanation
DosResetEventSem resets the post count of an event semaphore.
Gotchas
The process calling DosResetEventSem must first obtain access to the semaphore in question or ERROR_INVALID_HANDLE will be returned.
Sample Code
#define INCL_DOSSEMAPHORES #include <os2.h> HEV hevMySemaphore; /* MySemaphore handle */ ULONG PostCount /* storage for the post count of MySemaphore */ /* access is gained to the semaphore in question */ /* either by DosCreateEventSem ... */ /* ... or by DosOpenEventSem */ /* its handle is placed in hevMySemaphore */ /* process becomes owner of semaphore */ /* by way of successful call to DosRequestEventSem */ rc = DosResetEventSem(hevMySemaphore, &PostCount); if (rc != 0) { /* We got an error to take care of. */ }