DosCloseMuxWaitSem

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