DosCloseMuxWaitSem: Difference between revisions
mNo edit summary |
|||
| Line 1: | Line 1: | ||
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 === | === Syntax === | ||
rc = DosCloseMuxWaitSem( ''hmuxSemaphore'' ); | rc = DosCloseMuxWaitSem( ''hmuxSemaphore'' ); | ||
=== Parameters === | === Parameters === | ||
;HMUX ''hmuxSemaphore'' (input):The handle of the MuxWait semaphore to be closed. | |||
=== Returns === | === Returns === | ||
APIRET rc | |||
The following values can be returned | The following values can be returned | ||
{|class="wikitable" | |||
{| | |||
|- | |- | ||
|0 | |0 | ||
| Line 29: | Line 26: | ||
|Error, | |Error, | ||
Another thread is currently blocking on this MuxWait semaphore. | Another thread is currently blocking on this MuxWait semaphore. | ||
|} | |} | ||
=== Include Info === | === Include Info === | ||
#define INCL_DOSSEMAPHORES | #define INCL_DOSSEMAPHORES | ||
#include | #include <os2.h> | ||
=== Sample Code === | === Sample Code === | ||
| Line 66: | Line 51: | ||
} | } | ||
</PRE> | </PRE> | ||
=== See Also === | === See Also === | ||
[[ | *[[DosAddMuxWaitSem]] | ||
*[[DosCreateMuxWaitSem]] | |||
*[[DosDeleteMuxWaitSem]] | |||
*[[DosOpenMuxWaitSem]] | |||
*[[DosQueryMuxWaitSem]] | |||
*[[DosWaitMuxWaitSem]] | |||
[[Category: | [[Category:Dos]] | ||
Revision as of 18:02, 23 November 2016
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
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>
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. */
}