RMutex Class Reference

Creates a global mutex and opens this handle to the mutex.

The kernel side object representing the mutex is given the name contained in the specified descriptor, which makes it global. This means that any thread in any process can search for the mutex, using TFindMutex, and open a handle to it. If the specified name is empty the kernel side object representing the mutex is unnamed and so cannot be opened by name. It can however be passed to another process as a process parameter or via IPC.

By default, any thread in the process can use this instance of RMutex to access the mutex. However, specifying EOwnerThread as the second parameter to this function, means that only the creating thread can use this instance of RMutex to access the mutex; any other thread in this process that wants to access the mutex must either duplicate this handle or use OpenGlobal().

See also: OpenGlobal RHandleBase::Duplicate() TFindMutex

Creates a mutex and opens this handle to the mutex.

The kernel side object representing the mutex is unnamed. This means that it is not possible to search for the mutex, which makes it local to the current process.

By default, any thread in the process can use this instance of RMutex to access the mutex. However, specifying EOwnerThread as the parameter to this function, means that only the creating thread can use this instance of RMutex to access the mutex; any other thread in this process that wants to access the mutex must duplicate this handle.

See also: RHandleBase::Duplicate()

Test if this mutex is held by the current thread.

Opens a handle to the global mutex found using a TFindMutex object.

A TFindMutex object is used to find all global mutexes whose full names match a specified pattern.

By default, any thread in the process can use this instance of RMutex to access the mutex. However, specifying EOwnerThread as the second parameter to this function, means that only the opening thread can use this instance of RMutex to access the mutex; any other thread in this process that wants to access the mutex must either duplicate the handle or use OpenGlobal() again.

Opens a handle to a mutex using a handle number sent by a client to a server.

This function is called by the server.

Opens a handle to a mutex using a handle number passed as an environment data item to the child process during the creation of that child process.

Note that this function can only be called successfully once.

See also: RProcess::SetParameter()

Opens a handle to a global mutex.

Global mutexes are identified by name.

By default, any thread in the process can use this instance of RMutex to access the mutex. However, specifying EOwnerThread as the second parameter to this function, means that only the opening thread can use this instance of RMutex to access the mutex; any other thread in this process that wants to access the mutex must either duplicate the handle or use OpenGlobal() again.

See also: RHandleBase::Duplicate()

Acquire the mutex if it is currently free, but don't wait for it.

This function checks if the mutex is currently held. If not the mutex is marked as held by the current thread and the call returns immediately indicating success. If the mutex is held by another thread the call returns immediately indicating failure. If the mutex is already held by the current thread a count is maintained of how many times the thread has acquired the mutex.

Release the mutex.

This function decrements the count of how many times the current thread has acquired this mutex. If the count is now zero the mutex is marked as free and, if any other threads are waiting for the mutex to become free, the highest priority among those is made ready to run. However the mutex is not marked as held by any thread - the thread which has just been awakened must actually run in order to acquire the mutex.

Acquire the mutex, waiting for it to become free if necessary.

This function checks if the mutex is currently held. If not the mutex is marked as held by the current thread and the call returns immediately. If the mutex is held by another thread the current thread will suspend until the mutex becomes free. If the mutex is already held by the current thread a count is maintained of how many times the thread has acquired the mutex.

Acquire the mutex, if necessary waiting up to a specified maximum amount of time for it to become free.

This function checks if the mutex is currently held. If not the mutex is marked as held by the current thread and the call returns immediately. If the mutex is held by another thread the current thread will suspend until the mutex becomes free or until the specified timeout period has elapsed. If the mutex is already held by the current thread a count is maintained of how many times the thread has acquired the mutex.