DosCloseMuxWaitSem: Difference between revisions
Appearance
mNo edit summary |
mNo edit summary |
||
Line 12: | Line 12: | ||
:6 - ERROR_INVALID_HANDLE - Error, The value in ''hmuxSemaphore'' does not point to a valid semaphore | :6 - ERROR_INVALID_HANDLE - Error, The value in ''hmuxSemaphore'' does not point to a valid semaphore | ||
:301 - ERROR_SEM_BUSY - Error, Another thread is currently blocking on this MuxWait semaphore. | :301 - ERROR_SEM_BUSY - Error, Another thread is currently blocking on this MuxWait semaphore. | ||
==Sample Code== | |||
<PRE> | <PRE> | ||
#define INCL_DOSSEMAPHORES | #define INCL_DOSSEMAPHORES |
Latest revision as of 20:44, 29 November 2019
DosCloseMuxWaitSem decrements the usage count of a specified MuxWait semaphore. If the usage count of the semaphore reaches zero, the system frees the MuxWait semaphore resources.
Syntax
DosCloseMuxWaitSem( hmuxSemaphore )
Parameters
- HMUX hmuxSemaphore (input)
- The handle of the MuxWait semaphore to be closed.
Returns
- APIRET rc
- The following values can be returned
- 0 - NO_ERROR - Operation was successful.
- 6 - ERROR_INVALID_HANDLE - Error, The value in hmuxSemaphore does not point to a valid semaphore
- 301 - ERROR_SEM_BUSY - Error, Another thread is currently blocking on this MuxWait semaphore.
Sample Code
#define INCL_DOSSEMAPHORES #include <os2.h> HMUX hmuxMySemaphore; /* MySemaphore handle */ /* access is gained to the semaphore in question */ /* either by DosCreateMuxWaitSem ... */ /* ... or by DosOpenMuxWaitSem */ /* its handle is placed in hmuxMySemaphore */ rc = DosCloseMuxWaitSem(hmuxMySemaphore); if (rc != 0) { /* We got an error to take care of. */ }