[ Home | Alpha index | Topic index | Tutorials | Download | Feedback ]

The OS/2 API Project


[ Syntax | Params | Returns | Include | Usage | Structs | Gotchas | Code | Also ]


rc = DosResetEventSem( hevSemaphore, pulPostCount );


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.


The following values can be returned
0NO_ERRORSemaphore released successfully
6ERROR_INVALID_HANDLEError, The value in phevSemaphore does not point to a valid semaphore, The calling process must first have access to the semaphore in question
300ERROR_ALREADY_RESETError, The semaphore is already reset, no posts have occurred since last reset

Include Info

#include <os2.h>

Usage Explanation

DosResetEventSem resets the post count of an event semaphore.

Relevant Structures


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. */ }

See Also

DosCloseEventSem, DosCreateEventSem, DosOpenEventSem, DosPostEventSem DosQueryEventSem, DosWaitEventSem


Joe Phillips - jaiger@eng2.uconn.edu


Last modified June 19/1996
Please send all errors, comments, and suggestions to: timur@vnet.ibm.com

The OS/2 API Project