The OS/2 API Project

DosQueryMuxWaitSem

HMUX hmuxSemaphore (input)

The handle of the MuxWait semaphore to be queried.

PULONG pulSemaphoreRecords (input/output)

For input, this points to a ULONG that contains the number of SEMRECORDs that may be returned in the SEMRECORD structure pointed to by pSemaphoreRecord. If this value is not enough to contain all SEMRECORDs from the MuxWait list then ERROR_PARAM_TOO_SMALL is returned and this value points to the number of records in the MuxWait list. For output, this value points to the number of SEMRECORDs actually returned.

PSEMRECORD pSemaphoreRecord (output)

A pointer to a buffer that will get the SEMRECORDs.

PULONG pflAttributes (output)

The attribute flags that were specified when this MuxWait semaphore was created.

• DC_SEM_SHARED indicates the semaphore is shared.
• DCMW_WAIT_ANY indicates the semaphore will unblock if any of the semaphores in the MuxWait list either post or release.
• DCMW_WAIT_ALL indicates the semaphore will unblock only if all of the semaphores in the MuxWait list either post or release.

APIRET rc

The following values can be returned

0	NO_ERROR	Operation successful
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
105	ERROR_SEM_OWNER_DIED	Error, The owner of the semaphore has died without freeing the semaphore
289	ERROR_PARAM_TOO_SMALL	Error, The value pointed to by pulSemaphoreRecords is too small

Relevant Structures

Sample Code

Author

Additions

Last modified July 21/1996
Please send all errors, comments, and suggestions to: timur@vnet.ibm.com