DosCloseMuxWaitSem

From EDM2
Jump to: navigation, search

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. */
	}

See Also