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

The OS/2 API Project

DosQueryEventSem

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

Syntax

rc = DosQueryEventSem( hevSemaphore, pulPostCount );

Parameters

HEV hevSemaphore (input)
The handle (HEV) of the semaphore to be queried.

PUL pulPostCount (output)
A pointer to the ULONG that is to get the post count of the queried event semaphore. The post count is the number of DosPostEventSem calls that have been issued for the event semaphore described by hevSemaphore.

Returns

APIRET rc
The following values can be returned
0NO_ERRORSemaphore queried 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
87ERROR_INVALID_PARAMETERError, One or more parameters is not recognized, See parameters above

Include Info

#define INCL_DOSSEMAPHORES
#include <os2.h>

Usage Explanation

DosQueryEventSem returns the post count of the Event semaphore referred to by hevSemaphore.

Relevant Structures

Gotchas

The process calling DosQueryEventSem 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; /* my semaphore handle */ ULONG ulRequestCount; /* will get the request count for the sem */ /* access is gained to the semaphore in question */ /* either by DosCreateEventSem ... */ /* ... or by DosOpenEventSem */ /* its handle is placed in hevMySemaphore */ rc = DosQueryEventSem(hevMySemaphore, &ulRequestCount); if (rc != 0) { /* We got an error to take care of. */ }

See Also

DosCloseEventSem, DosCreateEventSem, DosOpenEventSem, DosPostEventSem DosResetEventSem DosWaitEventSem

Author

Joe Phillips - jaiger@eng2.uconn.edu

Additions

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

The OS/2 API Project

DosQueryEventSem