DosOpenMuxWaitSem - Parameters

pszName (PSZ) - input

A pointer to the ASCIIZ name of the semaphore to open.

If the semaphore is either a private or shared unnamed muxwait semaphore, this field must be null and the semaphore is identified by the pointer to the muxwait-semaphore handle (phmux).

If the semaphore is a shared named semaphore, this field is no null and phmux must be set to 0. (Private semaphores are always unnamed).

phmux (PHMUX) - in/out

Pointer to a muxwait-semaphore handle.

Input

A pointer to the muxwait-semaphore handle to open if pszName is null; otherwise, when using pszName, this field is set to zero.
Output
A pointer to the muxwait-semaphore handle that was opened.

ulrc (APIRET) - returns

Return Code.

DosOpenMuxWaitSem returns one of the following values:

• NO_ERROR 6
  ERROR_INVALID_HANDLE
  8
  ERROR_NOT_ENOUGH_MEMORY
  87
  ERROR_INVALID_PARAMETER
  105
  ERROR_SEM_OWNER_DIED
  123
  ERROR_INVALID_NAME
  187
  ERROR_SEM_NOT_FOUND
  291
  ERROR_TOO_MANY_OPENS
  For a full list of error codes, see Errors.

---

[Back: DosOpenMuxWaitSem Return Value - ulrc]
[Next: DosOpenMuxWaitSem - Remarks]