|6||ERROR_INVALID_HANDLE||Error, The value in phmuxSemaphore does not point to a valid semaphore|
|8||ERROR_NOT_ENOUGH_MEMORY||Error, The system memory limit has been exceeded|
|87||ERROR_INVALID_PARAMETER||Error, One or more parameters is not recognized, See parameters above, Both pszSemaphoreName and phmuxSemaphore may be NULL|
|95||ERROR_INTERRUPT||Error, The thread has become unblocked by an external event such as an exception|
|105||ERROR_SEM_OWNER_DIED||Error, The owner of a mutex semaphore in the muxwait list has died without freeing the semaphore|
|286||ERROR_EMPTY_MUXWAIT||Error, The MuxWait semaphore hmuxSemaphore is empty|
|287||ERROR_MUTEX_OWNED||Error, A mutex semaphore in the muxwait list is currently owned|
|640||ERROR_TIMEOUT||Error, The caller was blocked for ulTimeout milliseconds but ownership of the semaphore could not be obtained within this time limit, Time has expired|
MuxWait semaphores are edge triggered. This means that if a muxwait semaphore consists of a number of event semaphores and all have posted except for one, if one of the semaphores resets before the last hold-out posts then it will need to wait for the reset semaphore to post again.
If the MuxWait semaphore consists of mutex semaphores and was created with the DCMW_WAIT_ALL attribute, the process obtains ownership of all mutex semaphores only when all semaphores have been released. If the MuxWait semaphore was created with the DCMW_WAIT_ANY attribute, the process obtains ownership of the first mutex semaphore to release.
WinWaitMuxWaitSem is intended to be used in Presentation Manager applications in place of the DosWaitMuxWaitSem counterpart to avoid hanging the PM Message Queue.
The process calling WinWaitMuxWaitSem must first obtain access to
the semaphore in question or ERROR_INVALID_HANDLE will be returned.
If the thread to be blocked, waiting on an event semaphore, is not a PM thread, DosWaitMuxWaitSem should be used instead of WinWaitMuxWaitSem.
Last modified October 19/1996
Please send all errors, comments, and suggestions to: firstname.lastname@example.org
The OS/2 API Project