DosCreateMuxWaitSem - Parameters

pszName (PSZ) - input

Semaphore names are validated by the file system, and must include the prefix \SEM32\. A maximum of 255 characters is allowed. If these requirements are not met, ERROR_INVALID_NAME is returned. If the semaphore already exists, ERROR_DUPLICATE_NAME is returned.

If this field is null, the muxwait semaphore is unnamed. Unnamed semaphores can be either private or shared, depending on flAttr. They are identified by the semaphore handle that phmux points to.

By default, named semaphores are shared.

phmux (PHMUX) - output

A pointer to the handle of the muxwait semaphore.

cSemRec (ULONG) - input

pSemRec

pSemRec (PSEMRECORD) - input

This is the list of event or mutex semaphores that must be posted or released in order for the muxwait semaphore to clear.

flAttr (ULONG) - input

The attributes of the semaphore are a combination of the following values:

DC_SEM_SHARED The semaphore is shared when this bit is set; otherwise, it is a private semaphore. This bit is checked only if the semaphore is unnamed (that is, if pszName is null), because all named semaphores are shared.
DCMW_WAIT_ANY.
The semaphore clears when any event semaphore in its pSemRec list is posted, or when any mutex semaphore in its pSemRec list is released. When any one of the semaphores is cleared, the thread waiting for the muxwait semaphore can continue execution.
DCMW_WAIT_ALL
The semaphore clears when all of the event semaphores in its pSemRec list have been posted, or when all of the mutex semaphores in its pSemRec list have been released. When all of the semaphores are cleared, the thread waiting for the muxwait semaphore can continue execution.

ulrc (APIRET) - returns

DosCreateMuxWaitSem returns one of the following values:

NO_ERROR 6
8
87
100
105
123
284
285
290
292
For a full list of error codes, see Errors.

[Back: DosCreateMuxWaitSem Return Value - ulrc]

[Next: DosCreateMuxWaitSem - Remarks]