DosCloseMuxWaitSem

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

 * 1) define INCL_DOSSEMAPHORES
 * 2) 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. */	} 