DosOpenMuxWaitSem

DosOpenMuxWaitSem gains access to a shared MuxWait semaphore.

Syntax
rc = DosOpenMuxWaitSem( pszSemaphoreName,                        phmuxSemaphore );

Parameters

 * PSZ pszSemaphoreName (input):This is a pointer to NULL terminated string containing the name of the shared MuxWait semaphore to access. If this value is NULL then the semaphore to access is specified in phmuxSemaphore.
 * PHMUX phmuxSemaphore (input/output):For input, this value is a pointer to the MuxWait semaphore handle that should be openned if pszSemaphoreName is NULL. If :pszSemaphoreName is not NULL then this value must be NULL on input. For output, this is a pointer to the MuxWait semaphore handle (HMUX) to the openned semaphore.

Returns
APIRET rc The following values can be returned:

Gotchas
The process that created the MuxWait semaphore does not need to call this. The process wishing to use this function must first have gained access to all semaphores in the muxwait list of the MuxWait semaphore to which access is intended or ERROR_INVALID_HANDLE will be returned.