[ Home |
Alpha index |
Topic index |
Tutorials |
Download |
Feedback ]
The OS/2 API Project
DosCloseMuxWaitSem
[ Syntax |
Params |
Returns |
Include |
Usage |
Structs |
Gotchas |
Code |
Also ]
Syntax
rc = 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. |
Include Info
#define INCL_DOSSEMAPHORES
#include <os2.h>
Usage Explanation
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.
Relevant Structures
Gotchas
Sample Code
#define INCL_DOSSEMAPHORES
#include
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. */
}
See Also
DosAddMuxWaitSem,
DosCreateMuxWaitSem,
DosDeleteMuxWaitSem
DosOpenMuxWaitSem,
DosQueryMuxWaitSem,
DosWaitMuxWaitSem
Author
Joe Phillips -
jaiger@eng2.uconn.edu
Additions
Last modified July 17/1996
Please send all errors, comments, and suggestions to:
timur@vnet.ibm.com
The OS/2 API Project |
DosCloseMuxWaitSem |