DosQueryMutexSem - Parameters

hmtx (HMTX) - input

The handle of the mutex semaphore to query.

ppid (PID *) - output

A pointer to the process ID of either the current owner of the mutex semaphore, or a process that has ended without releasing the semaphore.

ptid (TID *) - output

A pointer to the thread ID of either the current owner of the mutex semaphore, or a process that has ended without releasing the semaphore.

pulCount (PULONG) - output

A pointer to the request count for the semaphore.

The request count is the number of calls to DosRequestMutexSem, minus the number of calls to DosReleaseMutexSem, that have been made for the semaphore by the owning thread. If the semaphore is unowned, this value will be zero. If the owning thread has ended, the value will be the request count for the ended owner.

ulrc (APIRET) - returns

Return Code.

DosQueryMutexSem returns one of the following values:

• NO_ERROR 6
  ERROR_INVALID_HANDLE
  87
  ERROR_INVALID_PARAMETER
  105
  ERROR_SEM_OWNER_DIED
  For a full list of error codes, see Errors.

---

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