Jump to content

DosCloseMuxWaitSem

From EDM2

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