RTMutexOpenExisting Method |
Opens an existing named mutex.
Namespace:
IntervalZero.RTX64.RTAPI.ThreadingAssembly: IntervalZero.RTX64 (in IntervalZero.RTX64.dll) Version: 3.3.0.0 (File version: 3.5.0)

Parameters
- name
- Type: SystemString
The name of a system-wide named mutex object.
Return Value
Type: RTMutexA RTMutex object that represents a named system mutex.

Exception | Condition |
---|---|
ArgumentException | Name is a zero-length string. -or- name is longer than 260 characters. |
ArgumentNullException | Name is a null reference (Nothing in Visual Basic). |
WaitHandleCannotBeOpenedException | The named mutex does not exist. |

The OpenExisting method attempts to open an existing named mutex.
If the system mutex does not exist, this method throws an exception instead of creating the system object.
Two calls to this method with the same value for name do not necessarily return the same RTMutex object, even though they represent the same named system mutex.
