lock_mutex — Lock a mutex synchronization object.
lock_mutex( : : MutexHandle : )
lock_mutex locks the mutex given by
MutexHandle. If the
mutex is currently unlocked, it becomes locked and owned by the calling
lock_mutex returns immediately. If the mutex is
already locked by another thread, the calling thread waits until the mutex
is unlocked. The kind of wait is defined by the mutex' attributes set during
Mutex synchronization object.
If the mutex handle is valid, the operator
lock_mutex returns 2 (H_MSG_TRUE).
If necessary, an exception is raised.