DosQueryMuxWaitSem - Parameters

hmux (HMUX) - input

The handle of the muxwait semaphore to query.

pcSemRec (PULONG) - in/out

A pointer to the ULONG which contains the number of semaphore record entries.

Input

A pointer to the maximum number of semaphore record entries that can be contained in the list pointed to by pSemRec.
Output
A pointer to the number of semaphore record entries returned in the list pointed to by pSemRec. If the list pointed to by pSemRec is not large enough to hold all of the semaphore records in the specified muxwait semaphore, the system sets the value pointed to by pSemRec to the number of semaphore records in the specified muxwait semaphore, and sets the return code to ERROR_PARAM_TOO_SMALL.

pSemRec (PSEMRECORD) - output

A pointer to the semaphore record entries in the muxwait-semaphore list.

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

pflAttr (PULONG) - output

A pointer to the flAttr attribute flags that were passed by DosCreateMuxWaitSem.

Possible flags are shown in the list below:

• DC_SEM_SHARED The semaphore is shared.

• DCMW_WAIT_ANY
  The semaphore waits for any event semaphore in the muxwait-semaphore list to be posted, or for any mutex semaphore in the list to be released. When any one of the semaphores is cleared, the thread that is waiting on the muxwait semaphore can continue executing.

• DCMW_WAIT_ALL
  The semaphore waits for all of the event semaphores in the muxwait list to be posted, or for all of the mutex semaphores in the list to be released. When all of the semaphores are cleared, the thread that is waiting on the muxwait semaphore can continue executing.

ulrc (APIRET) - returns

Return Code.

DosQueryMuxWaitSem 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
  289
  ERROR_PARAM_TOO_SMALL
  For a full list of error codes, see Errors.

---

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