[ 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
0NO_ERROROperation was successful.
6ERROR_INVALID_HANDLEError, The value in hmuxSemaphore does not point to a valid semaphore
301ERROR_SEM_BUSYError, 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 <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. */ }

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