Mutex Constructor (Boolean, String)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Initializes a new instance of the Mutex class with a Boolean value that indicates whether the calling thread should have initial ownership of the mutex, and a string that is the name of the mutex.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- initiallyOwned
- Type: System.Boolean
true to give the calling thread initial ownership of the named system mutex if the named system mutex is created as a result of this call; otherwise, false.
- name
- Type: System.String
The name of the Mutex. If the value is Nothing, the Mutex is unnamed.
| Exception | Condition |
|---|---|
| UnauthorizedAccessException | The named mutex exists and has access control security, but the user does not have the necessary access control rights. |
| ApplicationException | The named mutex cannot be created, perhaps because a wait handle of a different type has the same name. |
| ArgumentException | name is longer than 260 characters. |
If name is not Nothing and initiallyOwned is true, the calling thread owns the mutex only if the named system mutex was created as a result of this call. Since there is no mechanism for determining whether the named system mutex was created, it is better to specify false for initiallyOwned when calling this constructor. This constructor initializes a Mutex object that represents a named system mutex. You can create multiple Mutex objects that represent the same named system mutex.
Because they are system-wide, named mutexes can be used to coordinate resource use across process boundaries.
Version Notes
Windows Phone
In Windows Phone, private object namespaces are not supported. In the .NET Framework, object namespaces are supported and because of this the backslash (\) is considered a delimiter and is not supported in the name parameter. In Windows Phone you can use a backslash (\) in the name parameter.