Mutex Конструкторы

Определение

Пространство имен:
System.Threading
Сборки:
mscorlib.dll, System.Threading.dll
Сборки:
netstandard.dll, System.Threading.dll
Сборка:
System.Threading.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Инициализирует новый экземпляр класса Mutex.

Перегрузки

Имя Описание
Mutex()

Инициализирует новый экземпляр Mutex класса со свойствами по умолчанию.
Mutex(Boolean)

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом.
Mutex(Boolean, String)

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом и строку, которая является именем мьютекса.
Mutex(String, NamedWaitHandleOptions)

Инициализирует новый экземпляр Mutex класса строкой, которая является именем мьютекса и параметров для задания доступа к области сеанса и области пользователя. Вызывающий поток не запрашивает начальное владение мьютексом.
Mutex(Boolean, String, Boolean)

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строку, которая является именем мьютекса, и логическое значение, которое, когда метод возвращает, указывает, был ли вызывающий поток предоставлен первоначальное владение мьютексом.
Mutex(Boolean, String, NamedWaitHandleOptions)

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строкой, которая является именем мьютекса, а также параметрами для задания доступа к области пользователя и области сеанса.
Mutex(Boolean, String, Boolean, MutexSecurity)

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строка, представляющая имя мьютекса, логическая переменная, которая, когда метод возвращает, указывает, был ли вызывающий поток предоставлен начальное владение мьютексом, а также безопасность управления доступом, применяемая к именованной мьютексе.
Mutex(Boolean, String, NamedWaitHandleOptions, Boolean)

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строка, представляющая имя мьютекса, параметры для задания доступа к области пользователя и области сеанса, а также логическое значение, которое, когда метод возвращает, указывает, был ли вызывающий поток предоставлен начальное владение мьютексом.

Mutex()

Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs

Инициализирует новый экземпляр Mutex класса со свойствами по умолчанию.

public:
 Mutex();
public Mutex();
Public Sub New ()

Примеры

В следующем примере кода показано, как локальный Mutex объект используется для синхронизации доступа к защищенному ресурсу. Поток, создающий мьютекс, изначально не владеет им.

// This example shows how a Mutex is used to synchronize access
// to a protected resource. Unlike Monitor, Mutex can be used with
// WaitHandle.WaitAll and WaitAny, and can be passed across
// AppDomain boundaries.
 
using System;
using System.Threading;

class Test13
{
    // Create a new Mutex. The creating thread does not own the
    // Mutex.
    private static Mutex mut = new Mutex();
    private const int numIterations = 1;
    private const int numThreads = 3;

    static void Main()
    {
        // Create the threads that will use the protected resource.
        for(int i = 0; i < numThreads; i++)
        {
            Thread myThread = new Thread(new ThreadStart(MyThreadProc));
            myThread.Name = String.Format("Thread{0}", i + 1);
            myThread.Start();
        }

        // The main thread exits, but the application continues to
        // run until all foreground threads have exited.
    }

    private static void MyThreadProc()
    {
        for(int i = 0; i < numIterations; i++)
        {
            UseResource();
        }
    }

    // This method represents a resource that must be synchronized
    // so that only one thread at a time can enter.
    private static void UseResource()
    {
        // Wait until it is safe to enter.
        mut.WaitOne();

        Console.WriteLine("{0} has entered the protected area", 
            Thread.CurrentThread.Name);

        // Place code to access non-reentrant resources here.

        // Simulate some work.
        Thread.Sleep(500);

        Console.WriteLine("{0} is leaving the protected area\r\n", 
            Thread.CurrentThread.Name);
         
        // Release the Mutex.
        mut.ReleaseMutex();
    }
}

' This example shows how a Mutex is used to synchronize access
' to a protected resource. Unlike Monitor, Mutex can be used with
' WaitHandle.WaitAll and WaitAny, and can be passed across
' AppDomain boundaries.
 
Imports System.Threading

Class Test
    ' Create a new Mutex. The creating thread does not own the
    ' Mutex.
    Private Shared mut As New Mutex()
    Private Const numIterations As Integer = 1
    Private Const numThreads As Integer = 3

    <MTAThread> _
    Shared Sub Main()
        ' Create the threads that will use the protected resource.
        Dim i As Integer
        For i = 1 To numThreads
            Dim myThread As New Thread(AddressOf MyThreadProc)
            myThread.Name = [String].Format("Thread{0}", i)
            myThread.Start()
        Next i

        ' The main thread exits, but the application continues to
        ' run until all foreground threads have exited.

    End Sub

    Private Shared Sub MyThreadProc()
        Dim i As Integer
        For i = 1 To numIterations
            UseResource()
        Next i
    End Sub

    ' This method represents a resource that must be synchronized
    ' so that only one thread at a time can enter.
    Private Shared Sub UseResource()
        ' Wait until it is safe to enter.
        mut.WaitOne()

        Console.WriteLine("{0} has entered protected area", _
            Thread.CurrentThread.Name)

        ' Place code to access non-reentrant resources here.

        ' Simulate some work
        Thread.Sleep(500)

        Console.WriteLine("{0} is leaving protected area" & vbCrLf, _
            Thread.CurrentThread.Name)

        ' Release Mutex.
        mut.ReleaseMutex()
    End Sub
End Class

Комментарии

Вызов этой перегрузки конструктора совпадает Mutex(Boolean) с вызовом false перегрузки конструктора и указанием начального владения мьютексом. То есть вызывающий поток не владеет мьютексом.

См. также раздел

Применяется к

Mutex(Boolean)

Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом.

public:
 Mutex(bool initiallyOwned);
public Mutex(bool initiallyOwned);
new System.Threading.Mutex : bool -> System.Threading.Mutex
Public Sub New (initiallyOwned As Boolean)

Параметры

initiallyOwned
Boolean

true для предоставления вызывающему потоку первоначального владения мьютексом; falseв противном случае .

Примеры

В следующем примере кода показано, как локальный Mutex объект используется для синхронизации доступа к защищенному ресурсу. Поток, создающий Mutex его изначально.

using System;
using System.Threading;

class Test
{
    private static Mutex mut;
    private const int numIterations = 1;
    private const int numThreads = 3;

    static void Main()
    {
        // Create a new Mutex. The creating thread owns the Mutex.
        mut = new Mutex(true);
        // Create the threads that will use the protected resource.
        for(int i = 0; i < numThreads; i++)
        {
            Thread myThread = new Thread(new ThreadStart(MyThreadProc));
            myThread.Name = String.Format("Thread{0}", i + 1);
            myThread.Start();
        }

        // Wait one second before allowing other threads to
        // acquire the Mutex.
        Console.WriteLine("Creating thread owns the Mutex.");
        Thread.Sleep(1000);

        Console.WriteLine("Creating thread releases the Mutex.\r\n");
        mut.ReleaseMutex();
    }

    private static void MyThreadProc()
    {
        for(int i = 0; i < numIterations; i++)
        {
            UseResource();
        }
    }

    // This method represents a resource that must be synchronized
    // so that only one thread at a time can enter.
    private static void UseResource()
    {
        // Wait until it is safe to enter.
        mut.WaitOne();

        Console.WriteLine("{0} has entered the protected area", 
            Thread.CurrentThread.Name);

        // Place code to access non-reentrant resources here.

        // Simulate some work.
        Thread.Sleep(500);

        Console.WriteLine("{0} is leaving the protected area\r\n", 
            Thread.CurrentThread.Name);
         
        // Release the Mutex.
        mut.ReleaseMutex();
    }
}
// The example displays output like the following:
//       Creating thread owns the Mutex.
//       Creating thread releases the Mutex.
//       
//       Thread1 has entered the protected area
//       Thread1 is leaving the protected area
//       
//       Thread2 has entered the protected area
//       Thread2 is leaving the protected area
//       
//       Thread3 has entered the protected area
//       Thread3 is leaving the protected area

Imports System.Threading

Class Test
    ' Create a new Mutex. The creating thread owns the
    ' Mutex.
    Private Shared mut As New Mutex(True)
    Private Const numIterations As Integer = 1
    Private Const numThreads As Integer = 3

    <MTAThread> _
    Shared Sub Main()
        ' Create the threads that will use the protected resource.
        Dim i As Integer
        For i = 1 To numThreads
            Dim myThread As New Thread(AddressOf MyThreadProc)
            myThread.Name = [String].Format("Thread{0}", i)
            myThread.Start()
        Next i

        ' Wait one second before allowing other threads to
        ' acquire the Mutex.
        Console.WriteLine("Creating thread owns the Mutex.")
        Thread.Sleep(1000)

        Console.WriteLine("Creating thread releases the Mutex." & vbCrLf)
        mut.ReleaseMutex()
    End Sub

    Private Shared Sub MyThreadProc()
        Dim i As Integer
        For i = 1 To numIterations
            UseResource()
        Next i
    End Sub

    ' This method represents a resource that must be synchronized
    ' so that only one thread at a time can enter.
    Private Shared Sub UseResource()
        ' Wait until it is safe to enter.
        mut.WaitOne()

        Console.WriteLine("{0} has entered protected area", _
            Thread.CurrentThread.Name)

        ' Place code to access non-reentrant resources here.

        ' Simulate some work
        Thread.Sleep(500)

        Console.WriteLine("{0} is leaving protected area" & vbCrLf, _
            Thread.CurrentThread.Name)

        ' Release Mutex.
        mut.ReleaseMutex()
    End Sub
End Class
' The example displays output like the following:
'       Creating thread owns the Mutex.
'       Creating thread releases the Mutex.
'       
'       Thread1 has entered the protected area
'       Thread1 is leaving the protected area
'       
'       Thread2 has entered the protected area
'       Thread2 is leaving the protected area
'       
'       Thread3 has entered the protected area
'       Thread3 is leaving the protected area

См. также раздел

Применяется к

Mutex(Boolean, String)

Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом и строку, которая является именем мьютекса.

public:
 Mutex(bool initiallyOwned, System::String ^ name);
[System.Security.SecurityCritical]
public Mutex(bool initiallyOwned, string name);
public Mutex(bool initiallyOwned, string? name);
public Mutex(bool initiallyOwned, string name);
[<System.Security.SecurityCritical>]
new System.Threading.Mutex : bool * string -> System.Threading.Mutex
new System.Threading.Mutex : bool * string -> System.Threading.Mutex
Public Sub New (initiallyOwned As Boolean, name As String)

Параметры

initiallyOwned
Boolean

true , чтобы предоставить вызову первоначальное владение именованным системным мьютексом, если именованный системный мьютекс создается в результате этого вызова; falseв противном случае .

name
String

Имя, если объект синхронизации должен использоваться совместно с другими процессами; null в противном случае или пустая строка. Имя чувствительно к регистру. Символ обратной косой черты (\) зарезервирован и может использоваться только для указания пространства имен. Дополнительные сведения о пространствах имен см. в разделе примечаний. В зависимости от операционной системы могут быть дополнительные ограничения на имя. Например, в операционных системах на основе Unix имя после исключения пространства имен должно быть допустимым именем файла.

Атрибуты
SecurityCriticalAttribute

Исключения

UnauthorizedAccessException

Именованный мьютекс существует и имеет безопасность управления доступом, но у пользователя нет FullControl.

IOException

name недопустим. Это может быть по разным причинам, включая некоторые ограничения, которые могут быть помещены операционной системой, например неизвестный префикс или недопустимые символы. Обратите внимание, что имя и распространенные префиксы "Global\" и "Local\" чувствительны к регистру.

–или–

Произошла другая ошибка. Свойство HResult может предоставить дополнительные сведения.

DirectoryNotFoundException

Windows только: name указало неизвестное пространство имен. Дополнительные сведения см. в разделе "Имена объектов ".

PathTooLongException

Слишком длинное значение name. Ограничения длины могут зависеть от операционной системы или конфигурации.

WaitHandleCannotBeOpenedException

Не удается создать объект синхронизации с предоставленным name объектом. Объект синхронизации другого типа может иметь то же имя.

ArgumentException

только .NET Framework: name больше MAX_PATH (260 символов).

Примеры

В следующем примере показано, как именованный мьютекс используется для сигнала между потоками, работающими в двух отдельных процессах.

Запустите эту программу из двух или нескольких окон команд. Каждый процесс создает Mutex объект, представляющий именованный мьютекс MyMutex. Именованный мьютекс — это системный объект, время существования которого ограничивается временем существования Mutex объектов, представляющих его. Именованный мьютекс создается при первом процессе создания объекта Mutex . В этом примере именованный мьютекс принадлежит первому процессу, который запускает программу. Именованный мьютекс уничтожается при освобождении всех Mutex объектов, представляющих его.

Перегрузка конструктора, используемая в этом примере, не может определить, предоставлено ли первоначальное владение именованным мьютексом. Этот конструктор не следует использовать для запроса начального владения, если вы не можете быть уверены, что поток создаст именованный мьютекс.

using System;
using System.Threading;

public class Test1
{
    public static void Main()
    {
        // Create the named mutex. Only one system object named 
        // "MyMutex" can exist; the local Mutex object represents 
        // this system object, regardless of which process or thread
        // caused "MyMutex" to be created.
        Mutex m = new Mutex(false, "MyMutex");
        
        // Try to gain control of the named mutex. If the mutex is 
        // controlled by another thread, wait for it to be released.        
        Console.WriteLine("Waiting for the Mutex.");
        m.WaitOne();

        // Keep control of the mutex until the user presses
        // ENTER.
        Console.WriteLine("This application owns the mutex. " +
            "Press ENTER to release the mutex and exit.");
        Console.ReadLine();

        m.ReleaseMutex();
    }
}

Imports System.Threading

Public Class Test
   Public Shared Sub Main()
      ' Create the named mutex. Only one system object named 
      ' "MyMutex" can exist; the local Mutex object represents 
      ' this system object, regardless of which process or thread
      ' caused "MyMutex" to be created.
      Dim m As New Mutex(False, "MyMutex")
      
      ' Try to gain control of the named mutex. If the mutex is 
      ' controlled by another thread, wait for it to be released.        
      Console.WriteLine("Waiting for the Mutex.")
      m.WaitOne()
      
      ' Keep control of the mutex until the user presses
      ' ENTER.
      Console.WriteLine("This application owns the mutex. " _
          & "Press ENTER to release the mutex and exit.")
      Console.ReadLine()
      
      m.ReleaseMutex()
   End Sub 
End Class

Комментарии

Может name быть префиксирован или Global\Local\ указано пространство имен. Global При указании пространства имен объект синхронизации может быть предоставлен совместно с любыми процессами в системе. Local Если указано пространство имен, которое также является значением по умолчанию, если пространство имен не указано, объект синхронизации может быть предоставлен совместно с процессами в одном сеансе. В Windows сеанс является сеансом входа, а службы обычно выполняются в другом неинтерактивном сеансе. В операционных системах, таких как Unix, каждая оболочка имеет свой собственный сеанс. Объекты локальной синхронизации сеанса могут быть подходящими для синхронизации между процессами с отношением родительского или дочернего, где все они выполняются в одном сеансе. Дополнительные сведения о именах объектов синхронизации в Windows см. в разделе Object Names.

name Если указан и объект синхронизации запрошенного типа уже существует в пространстве имен, используется существующий объект синхронизации. Если объект синхронизации другого типа уже существует в пространстве имен, WaitHandleCannotBeOpenedException создается исключение. В противном случае создается новый объект синхронизации.

Если name это не так nullinitiallyOwnedtrue, вызывающий поток владеет мьютексом только в том случае, если именованный системный мьютекс был создан в результате этого вызова. Так как нет механизма определения того, был ли создан именованный системный мьютекс, лучше указать false при initiallyOwned вызове этой перегрузки конструктора. Конструктор можно использовать, если необходимо определить начальное Mutex(Boolean, String, Boolean) владение.

Этот конструктор инициализирует Mutex объект, представляющий именованный системный мьютекс. Можно создать несколько Mutex объектов, представляющих один и тот же именованный системный мьютекс.

Если именованный мьютекс уже создан с безопасностью управления доступом и вызывающий объект не имеет MutexRights.FullControl, создается исключение. Чтобы открыть существующий именованный мьютекс только с этими разрешениями, необходимыми для синхронизации действий потока, см. в этом методе OpenExisting .

Если задана null или пустая строка для name, создается локальный мьютекс, как если бы вы вызвали Mutex(Boolean) конструктор.

Так как они являются системными, именованные мьютексы можно использовать для координации использования ресурсов через границы процесса.

Note

На сервере, на котором выполняются службы терминалов, именованный системный мьютекс может иметь два уровня видимости. Если его имя начинается с префикса Global\, мьютекс отображается во всех сеансах сервера терминала. Если его имя начинается с префикса Local\, мьютекс отображается только в сеансе сервера терминала, где он был создан. В этом случае отдельный мьютекс с тем же именем может существовать в каждом из других сеансов сервера терминала на сервере. Если при создании именованного мьютекса не указан префикс, он принимает префикс Local\. В сеансе сервера терминала два мьютекса, имена которых отличаются только по их префиксам, являются отдельными мьютексами, и оба являются видимыми для всех процессов в сеансе сервера терминала. То есть имена Global\ префиксов и Local\ описание области имени мьютекса относительно сеансов сервера терминала, а не относительно процессов.

Предостережение

По умолчанию именованный мьютекс не ограничивается пользователем, создающим его. Другие пользователи могут открывать и использовать мьютекс, включая вмешательство в мьютекс, вводя мьютекс и не выходя из него. В операционных системах, таких как Unix, файловая система используется в реализации именованных мьютексов, а другие пользователи могут вмешиваться в именованные мьютексы более значительными способами. Windows Для ограничения доступа к определенным пользователям можно использовать перегрузку конструктора или MutexAcl и передать MutexSecurity при создании именованного мьютекса. В операционных системах, таких как Unix, в настоящее время нет способа ограничить доступ к именованному мьютексу. Избегайте использования именованных мьютексов без ограничений доступа в системах, которые могут иметь ненадежных пользователей, выполняющих код.

Обратная косая черта (\) — это зарезервированный символ в имени мьютекса. Не используйте обратную косую черту (\) в имени мьютекса, за исключением указанного в заметке об использовании мьютексов в сеансах сервера терминалов. В противном случае может возникать исключение, DirectoryNotFoundException даже если имя мьютекса представляет существующий файл.

См. также раздел

Применяется к

Mutex(String, NamedWaitHandleOptions)

Исходный код:
Mutex.cs
Исходный код:
Mutex.cs

Инициализирует новый экземпляр Mutex класса строкой, которая является именем мьютекса и параметров для задания доступа к области сеанса и области пользователя. Вызывающий поток не запрашивает начальное владение мьютексом.

public:
 Mutex(System::String ^ name, System::Threading::NamedWaitHandleOptions options);
public Mutex(string? name, System.Threading.NamedWaitHandleOptions options);
new System.Threading.Mutex : string * System.Threading.NamedWaitHandleOptions -> System.Threading.Mutex
Public Sub New (name As String, options As NamedWaitHandleOptions)

Параметры

name
String

Имя, если объект синхронизации должен использоваться совместно с другими процессами; null в противном случае или пустая строка. Имя чувствительно к регистру.

options
NamedWaitHandleOptions

Параметры области именованного системного мьютекса. По умолчанию доступ ограничен текущим пользователем и текущим сеансом. Указанные параметры могут повлиять на пространство имен для имени и доступа к базовому объекту мьютекса системы.

Исключения

UnauthorizedAccessException

Именованный мьютекс существует и имеет безопасность управления доступом, но у пользователя нет FullControl.

IOException

name недопустим. Это может быть по разным причинам, включая некоторые ограничения, которые могут быть помещены операционной системой, например неизвестный префикс или недопустимые символы. Обратите внимание, что имя и распространенные префиксы "Global\" и "Local\" чувствительны к регистру.

–или–

Произошла другая ошибка. Свойство HResult может предоставить дополнительные сведения.

DirectoryNotFoundException

Windows только: name указало неизвестное пространство имен. Дополнительные сведения см. в разделе "Имена объектов ".

PathTooLongException

Слишком длинное значение name. Ограничения длины могут зависеть от операционной системы или конфигурации.

WaitHandleCannotBeOpenedException

Не удается создать объект синхронизации с предоставленным name объектом. Объект синхронизации другого типа может иметь то же имя. –или–

Объект с указанным name существует, но указанный options не совместим с параметрами существующего объекта.

Комментарии

name Если указан объект синхронизации запрошенного типа уже существует в пространстве имен, то используется существующий объект синхронизации, однако если options указан доступ, ограниченный текущим пользователем, а объект синхронизации несовместим с ним, WaitHandleCannotBeOpenedException создается исключение. Если объект синхронизации другого типа уже существует в пространстве имен, WaitHandleCannotBeOpenedException создается также. В противном случае создается новый объект синхронизации.

Этот конструктор инициализирует Mutex объект, представляющий именованный системный мьютекс. Можно создать несколько Mutex объектов, представляющих один и тот же именованный системный мьютекс.

Если именованный мьютекс уже создан с безопасностью управления доступом и вызывающий объект не имеет MutexRights.FullControl, создается исключение. Чтобы открыть существующий именованный мьютекс только с этими разрешениями, необходимыми для синхронизации действий потока, см. в этом методе OpenExisting .

Если задана null или пустая строка для name, создается локальный мьютекс, как если бы вы вызвали Mutex(Boolean) конструктор.

Так как они являются системными, именованные мьютексы можно использовать для координации использования ресурсов через границы процесса.

Этот options параметр можно указать, доступен ли именованный мьютекс текущему пользователю только или всем пользователям. Он также позволяет указать, доступен ли именованный мьютекс для процессов только в текущем сеансе или ко всем сеансам. Дополнительные сведения см. в разделе NamedWaitHandleOptions.

Обратная косая черта (\) — это зарезервированный символ в имени мьютекса. Не используйте обратную косую черту (\) в имени мьютекса, за исключением указанного в заметке об использовании мьютексов в сеансах сервера терминалов. В противном случае может возникать исключение, DirectoryNotFoundException даже если имя мьютекса представляет существующий файл.

См. также раздел

Применяется к

Mutex(Boolean, String, Boolean)

Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs
Исходный код:
Mutex.cs

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строку, которая является именем мьютекса, и логическое значение, которое, когда метод возвращает, указывает, был ли вызывающий поток предоставлен первоначальное владение мьютексом.

public:
 Mutex(bool initiallyOwned, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew);
[System.Security.SecurityCritical]
public Mutex(bool initiallyOwned, string name, out bool createdNew);
public Mutex(bool initiallyOwned, string? name, out bool createdNew);
public Mutex(bool initiallyOwned, string name, out bool createdNew);
[<System.Security.SecurityCritical>]
new System.Threading.Mutex : bool * string * bool -> System.Threading.Mutex
new System.Threading.Mutex : bool * string * bool -> System.Threading.Mutex
Public Sub New (initiallyOwned As Boolean, name As String, ByRef createdNew As Boolean)

Параметры

initiallyOwned
Boolean

true , чтобы предоставить вызову первоначальное владение именованным системным мьютексом, если именованный системный мьютекс создается в результате этого вызова; falseв противном случае .

name
String

Имя, если объект синхронизации должен использоваться совместно с другими процессами; null в противном случае или пустая строка. Имя чувствительно к регистру. Символ обратной косой черты (\) зарезервирован и может использоваться только для указания пространства имен. Дополнительные сведения о пространствах имен см. в разделе примечаний. В зависимости от операционной системы могут быть дополнительные ограничения на имя. Например, в операционных системах на основе Unix имя после исключения пространства имен должно быть допустимым именем файла.

createdNew
Boolean

Когда этот метод возвращается, содержит логическое значение, то true есть если локальный мьютекс был создан (то есть, если name это null или пустая строка) или был создан указанный именованный системный мьютекс; false если указанный именованный системный мьютекс уже существует. Этот параметр передается неинициализирован.

Атрибуты
SecurityCriticalAttribute

Исключения

UnauthorizedAccessException

Именованный мьютекс существует и имеет безопасность управления доступом, но у пользователя нет FullControl.

IOException

name недопустим. Это может быть по разным причинам, включая некоторые ограничения, которые могут быть помещены операционной системой, например неизвестный префикс или недопустимые символы. Обратите внимание, что имя и распространенные префиксы "Global\" и "Local\" чувствительны к регистру.

–или–

Произошла другая ошибка. Свойство HResult может предоставить дополнительные сведения.

DirectoryNotFoundException

Windows только: name указало неизвестное пространство имен. Дополнительные сведения см. в разделе "Имена объектов ".

PathTooLongException

Слишком длинное значение name. Ограничения длины могут зависеть от операционной системы или конфигурации.

WaitHandleCannotBeOpenedException

Не удается создать объект синхронизации с предоставленным name объектом. Объект синхронизации другого типа может иметь то же имя.

ArgumentException

только .NET Framework: name больше MAX_PATH (260 символов).

Примеры

В следующем примере кода показано, как именованный мьютекс используется для сигнала между процессами или потоками. Запустите эту программу из двух или нескольких окон команд. Каждый процесс создает объект, представляющий именованный Mutex мьютекс MyMutex. Именованный мьютекс является системным объектом. В этом примере его время существования ограничивается временем существования Mutex объектов, представляющих его. Именованный мьютекс создается, когда первый процесс создает локальный Mutex объект и уничтожается при освобождении всех Mutex объектов, представляющих его. Именованный мьютекс изначально принадлежит первому процессу. Второй процесс и все последующие процессы ожидают, пока предыдущие процессы будут освобождены именованным мьютексом.

// This example shows how a named mutex is used to signal between
// processes or threads.
// Run this program from two (or more) command windows. Each process
// creates a Mutex object that represents the named mutex "MyMutex".
// The named mutex is a system object whose lifetime is bounded by the
// lifetimes of the Mutex objects that represent it. The named mutex
// is created when the first process creates its local Mutex; in this
// example, the named mutex is owned by the first process. The named 
// mutex is destroyed when all the Mutex objects that represent it
// have been released. 
// The second process (and any subsequent process) waits for earlier
// processes to release the named mutex.

using System;
using System.Threading;

public class Test12
{
    public static void Main()
    {
        // Set this variable to false if you do not want to request 
        // initial ownership of the named mutex.
        bool requestInitialOwnership = true;
        bool mutexWasCreated;

        // Request initial ownership of the named mutex by passing
        // true for the first parameter. Only one system object named 
        // "MyMutex" can exist; the local Mutex object represents 
        // this system object. If "MyMutex" is created by this call,
        // then mutexWasCreated contains true; otherwise, it contains
        // false.
        Mutex m = new Mutex(requestInitialOwnership, 
                            "MyMutex", 
                            out mutexWasCreated);
        
        // This thread owns the mutex only if it both requested 
        // initial ownership and created the named mutex. Otherwise,
        // it can request the named mutex by calling WaitOne.
        if (!(requestInitialOwnership && mutexWasCreated))
        {
            Console.WriteLine("Waiting for the named mutex.");
            m.WaitOne();
        }

        // Once the process has gained control of the named mutex,
        // hold onto it until the user presses ENTER.
        Console.WriteLine("This process owns the named mutex. " +
            "Press ENTER to release the mutex and exit.");
        Console.ReadLine();

        // Call ReleaseMutex to allow other threads to gain control
        // of the named mutex. If you keep a reference to the local
        // Mutex, you can call WaitOne to request control of the 
        // named mutex.
        m.ReleaseMutex();
    }
}

' This example shows how a named mutex is used to signal between
' processes or threads.
' Run this program from two (or more) command windows. Each process
' creates a Mutex object that represents the named mutex "MyMutex".
' The named mutex is a system object whose lifetime is bounded by the
' lifetimes of the Mutex objects that represent it. The named mutex
' is created when the first process creates its local Mutex; in this
' example, the named mutex is owned by the first process. The named 
' mutex is destroyed when all the Mutex objects that represent it
' have been released. 
' The second process (and any subsequent process) waits for earlier
' processes to release the named mutex.

Imports System.Threading

Public Class Test
   
   <MTAThread> _
   Public Shared Sub Main()
      ' Set this variable to false if you do not want to request 
      ' initial ownership of the named mutex.
      Dim requestInitialOwnership As Boolean = True
      Dim mutexWasCreated As Boolean
      
      ' Request initial ownership of the named mutex by passing
      ' true for the first parameter. Only one system object named 
      ' "MyMutex" can exist; the local Mutex object represents 
      ' this system object. If "MyMutex" is created by this call,
      ' then mutexWasCreated contains true; otherwise, it contains
      ' false.
      Dim m As New Mutex(requestInitialOwnership, "MyMutex", _
          mutexWasCreated)
      
      ' This thread owns the mutex only if it both requested 
      ' initial ownership and created the named mutex. Otherwise,
      ' it can request the named mutex by calling WaitOne.
      If Not (requestInitialOwnership And mutexWasCreated) Then
         Console.WriteLine("Waiting for the named mutex.")
         m.WaitOne()
      End If
      
      ' Once the process has gained control of the named mutex,
      ' hold onto it until the user presses ENTER.
      Console.WriteLine("This process owns the named mutex. " _
          & "Press ENTER to release the mutex and exit.")
      Console.ReadLine()
      
      ' Call ReleaseMutex to allow other threads to gain control
      ' of the named mutex. If you keep a reference to the local
      ' Mutex, you can call WaitOne to request control of the 
      ' named mutex.
      m.ReleaseMutex()
   End Sub
End Class

Комментарии

Может name быть префиксирован или Global\Local\ указано пространство имен. Global При указании пространства имен объект синхронизации может быть предоставлен совместно с любыми процессами в системе. Local Если указано пространство имен, которое также является значением по умолчанию, если пространство имен не указано, объект синхронизации может быть предоставлен совместно с процессами в одном сеансе. В Windows сеанс является сеансом входа, а службы обычно выполняются в другом неинтерактивном сеансе. В операционных системах, таких как Unix, каждая оболочка имеет свой собственный сеанс. Объекты локальной синхронизации сеанса могут быть подходящими для синхронизации между процессами с отношением родительского или дочернего, где все они выполняются в одном сеансе. Дополнительные сведения о именах объектов синхронизации в Windows см. в разделе Object Names.

name Если указан и объект синхронизации запрошенного типа уже существует в пространстве имен, используется существующий объект синхронизации. Если объект синхронизации другого типа уже существует в пространстве имен, WaitHandleCannotBeOpenedException создается исключение. В противном случае создается новый объект синхронизации.

Если name это не так nullinitiallyOwnedtrue, вызывающий поток владеет именованным мьютексом, только если createdNew после true вызова. В противном случае поток может запросить мьютекс, вызвав WaitOne метод.

Этот конструктор инициализирует Mutex объект, представляющий именованный системный мьютекс. Можно создать несколько Mutex объектов, представляющих один и тот же именованный системный мьютекс.

Если именованный мьютекс уже создан с безопасностью управления доступом и вызывающий не имеет MutexRights.FullControl прав, создается исключение. Чтобы открыть существующий именованный мьютекс только с этими разрешениями, необходимыми для синхронизации действий потока, см. в этом методе OpenExisting .

Если задана null или пустая строка для name, создается локальный мьютекс, как если бы вы вызвали Mutex(Boolean) конструктор. В этом случае createdNew всегда true.

Так как они являются системными, именованные мьютексы можно использовать для координации использования ресурсов через границы процесса.

Note

На сервере, на котором выполняются службы терминалов, именованный системный мьютекс может иметь два уровня видимости. Если его имя начинается с префикса Global\, мьютекс отображается во всех сеансах сервера терминала. Если его имя начинается с префикса Local\, мьютекс отображается только в сеансе сервера терминала, где он был создан. В этом случае отдельный мьютекс с тем же именем может существовать в каждом из других сеансов сервера терминала на сервере. Если при создании именованного мьютекса не указан префикс, он принимает префикс Local\. В сеансе сервера терминала два мьютекса, имена которых отличаются только по их префиксам, являются отдельными мьютексами, и оба являются видимыми для всех процессов в сеансе сервера терминала. То есть имена Global\ префиксов и Local\ описание области имени мьютекса относительно сеансов сервера терминала, а не относительно процессов.

Предостережение

По умолчанию именованный мьютекс не ограничивается пользователем, создающим его. Другие пользователи могут открывать и использовать мьютекс, включая вмешательство в мьютекс, вводя мьютекс и не выходя из него. В операционных системах, таких как Unix, файловая система используется в реализации именованных мьютексов, а другие пользователи могут вмешиваться в именованные мьютексы более значительными способами. Windows Для ограничения доступа к определенным пользователям можно использовать перегрузку конструктора или MutexAcl и передать MutexSecurity при создании именованного мьютекса. В операционных системах, таких как Unix, в настоящее время нет способа ограничить доступ к именованному мьютексу. Избегайте использования именованных мьютексов без ограничений доступа в системах, которые могут иметь ненадежных пользователей, выполняющих код.

Обратная косая черта (\) — это зарезервированный символ в имени мьютекса. Не используйте обратную косую черту (\) в имени мьютекса, за исключением указанного в заметке об использовании мьютексов в сеансах сервера терминалов. В противном случае может возникать исключение, DirectoryNotFoundException даже если имя мьютекса представляет существующий файл.

См. также раздел

Применяется к

Mutex(Boolean, String, NamedWaitHandleOptions)

Исходный код:
Mutex.cs
Исходный код:
Mutex.cs

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строкой, которая является именем мьютекса, а также параметрами для задания доступа к области пользователя и области сеанса.

public:
 Mutex(bool initiallyOwned, System::String ^ name, System::Threading::NamedWaitHandleOptions options);
public Mutex(bool initiallyOwned, string? name, System.Threading.NamedWaitHandleOptions options);
new System.Threading.Mutex : bool * string * System.Threading.NamedWaitHandleOptions -> System.Threading.Mutex
Public Sub New (initiallyOwned As Boolean, name As String, options As NamedWaitHandleOptions)

Параметры

initiallyOwned
Boolean

true , чтобы предоставить вызову первоначальное владение именованным системным мьютексом, если именованный системный мьютекс создается в результате этого вызова; falseв противном случае .

name
String

Имя, если объект синхронизации должен использоваться совместно с другими процессами; null в противном случае или пустая строка. Имя чувствительно к регистру.

options
NamedWaitHandleOptions

Параметры области именованного системного мьютекса. По умолчанию доступ ограничен текущим пользователем и текущим сеансом. Указанные параметры могут повлиять на пространство имен для имени и доступа к базовому объекту мьютекса системы.

Исключения

UnauthorizedAccessException

Именованный мьютекс существует и имеет безопасность управления доступом, но у пользователя нет FullControl.

IOException

name недопустим. Это может быть по разным причинам, включая некоторые ограничения, которые могут быть помещены операционной системой, например неизвестный префикс или недопустимые символы. Обратите внимание, что имя и распространенные префиксы "Global\" и "Local\" чувствительны к регистру.

–или–

Произошла другая ошибка. Свойство HResult может предоставить дополнительные сведения.

DirectoryNotFoundException

Windows только: name указало неизвестное пространство имен. Дополнительные сведения см. в разделе "Имена объектов ".

PathTooLongException

Слишком длинное значение name. Ограничения длины могут зависеть от операционной системы или конфигурации.

WaitHandleCannotBeOpenedException

Не удается создать объект синхронизации с предоставленным name объектом. Объект синхронизации другого типа может иметь то же имя. –или–

Объект с указанным name существует, но указанный options не совместим с параметрами существующего объекта.

Комментарии

name Если указан объект синхронизации запрошенного типа уже существует в пространстве имен, то используется существующий объект синхронизации, однако если options указан доступ, ограниченный текущим пользователем, а объект синхронизации несовместим с ним, WaitHandleCannotBeOpenedException создается исключение. Если объект синхронизации другого типа уже существует в пространстве имен, WaitHandleCannotBeOpenedException создается также. В противном случае создается новый объект синхронизации.

Если name это не так nullinitiallyOwnedtrue, вызывающий поток владеет мьютексом только в том случае, если именованный системный мьютекс был создан в результате этого вызова. Так как нет механизма определения того, был ли создан именованный системный мьютекс, лучше указать false при initiallyOwned вызове этой перегрузки конструктора. Конструктор можно использовать, если необходимо определить начальное Mutex(Boolean, String, Boolean) владение.

Этот конструктор инициализирует Mutex объект, представляющий именованный системный мьютекс. Можно создать несколько Mutex объектов, представляющих один и тот же именованный системный мьютекс.

Если именованный мьютекс уже создан с безопасностью управления доступом и вызывающий объект не имеет MutexRights.FullControl, создается исключение. Чтобы открыть существующий именованный мьютекс только с этими разрешениями, необходимыми для синхронизации действий потока, см. в этом методе OpenExisting .

Если задана null или пустая строка для name, создается локальный мьютекс, как если бы вы вызвали Mutex(Boolean) конструктор.

Так как они являются системными, именованные мьютексы можно использовать для координации использования ресурсов через границы процесса.

Этот options параметр можно указать, доступен ли именованный мьютекс текущему пользователю только или всем пользователям. Он также позволяет указать, доступен ли именованный мьютекс для процессов только в текущем сеансе или ко всем сеансам. Дополнительные сведения см. в разделе NamedWaitHandleOptions.

См. также раздел

Применяется к

Mutex(Boolean, String, Boolean, MutexSecurity)

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строка, представляющая имя мьютекса, логическая переменная, которая, когда метод возвращает, указывает, был ли вызывающий поток предоставлен начальное владение мьютексом, а также безопасность управления доступом, применяемая к именованной мьютексе.

public:
 Mutex(bool initiallyOwned, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew, System::Security::AccessControl::MutexSecurity ^ mutexSecurity);
public Mutex(bool initiallyOwned, string name, out bool createdNew, System.Security.AccessControl.MutexSecurity mutexSecurity);
[System.Security.SecurityCritical]
public Mutex(bool initiallyOwned, string name, out bool createdNew, System.Security.AccessControl.MutexSecurity mutexSecurity);
new System.Threading.Mutex : bool * string * bool * System.Security.AccessControl.MutexSecurity -> System.Threading.Mutex
[<System.Security.SecurityCritical>]
new System.Threading.Mutex : bool * string * bool * System.Security.AccessControl.MutexSecurity -> System.Threading.Mutex
Public Sub New (initiallyOwned As Boolean, name As String, ByRef createdNew As Boolean, mutexSecurity As MutexSecurity)

Параметры

initiallyOwned
Boolean

true , чтобы предоставить вызову первоначальное владение именованным системным мьютексом, если именованный системный мьютекс создается в результате этого вызова; falseв противном случае .

name
String

Имя, если объект синхронизации должен использоваться совместно с другими процессами; null в противном случае или пустая строка. Имя чувствительно к регистру. Символ обратной косой черты (\) зарезервирован и может использоваться только для указания пространства имен. Дополнительные сведения о пространствах имен см. в разделе примечаний. В зависимости от операционной системы могут быть дополнительные ограничения на имя. Например, в операционных системах на основе Unix имя после исключения пространства имен должно быть допустимым именем файла.

createdNew
Boolean

Когда этот метод возвращается, содержит логическое значение, то true есть если локальный мьютекс был создан (то есть, если name это null или пустая строка) или был создан указанный именованный системный мьютекс; false если указанный именованный системный мьютекс уже существует. Этот параметр передается неинициализирован.

mutexSecurity
MutexSecurity

MutexSecurity Объект, представляющий безопасность управления доступом, применяемый к именованной системе мьютекса.

Атрибуты
SecurityCriticalAttribute

Исключения

IOException

name недопустим. Это может быть по разным причинам, включая некоторые ограничения, которые могут быть помещены операционной системой, например неизвестный префикс или недопустимые символы. Обратите внимание, что имя и распространенные префиксы "Global\" и "Local\" чувствительны к регистру.

–или–

Произошла другая ошибка. Свойство HResult может предоставить дополнительные сведения.

DirectoryNotFoundException

Windows только: name указало неизвестное пространство имен. Дополнительные сведения см. в разделе "Имена объектов ".

PathTooLongException

Слишком длинное значение name. Ограничения длины могут зависеть от операционной системы или конфигурации.

UnauthorizedAccessException

Именованный мьютекс существует и имеет безопасность управления доступом, но у пользователя нет FullControl.

WaitHandleCannotBeOpenedException

Не удается создать объект синхронизации с предоставленным name объектом. Объект синхронизации другого типа может иметь то же имя.

ArgumentException

только .NET Framework: name больше MAX_PATH (260 символов).

Примеры

В следующем примере кода демонстрируется кросспроцессное поведение именованного мьютекса с безопасностью управления доступом. В примере используется перегрузка OpenExisting(String) метода для проверки существования именованного мьютекса.

Если мьютекс не существует, он создается с начальной безопасностью владения и контроля доступа, которая запрещает текущему пользователю право использовать мьютекс, но предоставляет право на чтение и изменение разрешений на мьютекс.

Если выполнить скомпилированный пример из двух командных окон, вторая копия вызовет исключение нарушения доступа.OpenExisting(String) Исключение перехватится, и в примере используется OpenExisting(String, MutexRights) перегрузка метода для открытия мьютекса с правами, необходимыми для чтения и изменения разрешений.

После изменения разрешений мьютекс открывается с правами, необходимыми для ввода и освобождения. Если выполнить скомпилированный пример из третьего командного окна, он запускается с помощью новых разрешений.

using System;
using System.Threading;
using System.Security.AccessControl;

internal class Example
{
    internal static void Main()
    {
        const string mutexName = "MutexExample4";

        Mutex m = null;
        bool doesNotExist = false;
        bool unauthorized = false;

        // The value of this variable is set by the mutex
        // constructor. It is true if the named system mutex was
        // created, and false if the named mutex already existed.
        //
        bool mutexWasCreated = false;

        // Attempt to open the named mutex.
        try
        {
            // Open the mutex with (MutexRights.Synchronize |
            // MutexRights.Modify), to enter and release the
            // named mutex.
            //
            m = Mutex.OpenExisting(mutexName);
        }
        catch(WaitHandleCannotBeOpenedException)
        {
            Console.WriteLine("Mutex does not exist.");
            doesNotExist = true;
        }
        catch(UnauthorizedAccessException ex)
        {
            Console.WriteLine("Unauthorized access: {0}", ex.Message);
            unauthorized = true;
        }

        // There are three cases: (1) The mutex does not exist.
        // (2) The mutex exists, but the current user doesn't 
        // have access. (3) The mutex exists and the user has
        // access.
        //
        if (doesNotExist)
        {
            // The mutex does not exist, so create it.

            // Create an access control list (ACL) that denies the
            // current user the right to enter or release the 
            // mutex, but allows the right to read and change
            // security information for the mutex.
            //
            string user = Environment.UserDomainName + "\\"
                + Environment.UserName;
            var mSec = new MutexSecurity();

            MutexAccessRule rule = new MutexAccessRule(user, 
                MutexRights.Synchronize | MutexRights.Modify, 
                AccessControlType.Deny);
            mSec.AddAccessRule(rule);

            rule = new MutexAccessRule(user, 
                MutexRights.ReadPermissions | MutexRights.ChangePermissions,
                AccessControlType.Allow);
            mSec.AddAccessRule(rule);

            // Create a Mutex object that represents the system
            // mutex named by the constant 'mutexName', with
            // initial ownership for this thread, and with the
            // specified security access. The Boolean value that 
            // indicates creation of the underlying system object
            // is placed in mutexWasCreated.
            //
            m = new Mutex(true, mutexName, out mutexWasCreated, mSec);

            // If the named system mutex was created, it can be
            // used by the current instance of this program, even 
            // though the current user is denied access. The current
            // program owns the mutex. Otherwise, exit the program.
            // 
            if (mutexWasCreated)
            {
                Console.WriteLine("Created the mutex.");
            }
            else
            {
                Console.WriteLine("Unable to create the mutex.");
                return;
            }
        }
        else if (unauthorized)
        {
            // Open the mutex to read and change the access control
            // security. The access control security defined above
            // allows the current user to do this.
            //
            try
            {
                m = Mutex.OpenExisting(mutexName, 
                    MutexRights.ReadPermissions | MutexRights.ChangePermissions);

                // Get the current ACL. This requires 
                // MutexRights.ReadPermissions.
                MutexSecurity mSec = m.GetAccessControl();
                
                string user = Environment.UserDomainName + "\\"
                    + Environment.UserName;

                // First, the rule that denied the current user 
                // the right to enter and release the mutex must
                // be removed.
                MutexAccessRule rule = new MutexAccessRule(user, 
                     MutexRights.Synchronize | MutexRights.Modify,
                     AccessControlType.Deny);
                mSec.RemoveAccessRule(rule);

                // Now grant the user the correct rights.
                // 
                rule = new MutexAccessRule(user, 
                    MutexRights.Synchronize | MutexRights.Modify,
                    AccessControlType.Allow);
                mSec.AddAccessRule(rule);

                // Update the ACL. This requires
                // MutexRights.ChangePermissions.
                m.SetAccessControl(mSec);

                Console.WriteLine("Updated mutex security.");

                // Open the mutex with (MutexRights.Synchronize 
                // | MutexRights.Modify), the rights required to
                // enter and release the mutex.
                //
                m = Mutex.OpenExisting(mutexName);
            }
            catch(UnauthorizedAccessException ex)
            {
                Console.WriteLine("Unable to change permissions: {0}",
                    ex.Message);
                return;
            }
        }

        // If this program created the mutex, it already owns
        // the mutex.
        //
        if (!mutexWasCreated)
        {
            // Enter the mutex, and hold it until the program
            // exits.
            //
            try
            {
                Console.WriteLine("Wait for the mutex.");
                m.WaitOne();
                Console.WriteLine("Entered the mutex.");
            }
            catch(UnauthorizedAccessException ex)
            {
                Console.WriteLine("Unauthorized access: {0}", ex.Message);
            }
        }

        Console.WriteLine("Press the Enter key to exit.");
        Console.ReadLine();
        m.ReleaseMutex();
        m.Dispose();
    }
}

Imports System.Threading
Imports System.Security.AccessControl

Friend Class Example

    <MTAThread> _
    Friend Shared Sub Main()
        Const mutexName As String = "MutexExample4"

        Dim m As Mutex = Nothing
        Dim doesNotExist as Boolean = False
        Dim unauthorized As Boolean = False

        ' The value of this variable is set by the mutex
        ' constructor. It is True if the named system mutex was
        ' created, and False if the named mutex already existed.
        '
        Dim mutexWasCreated As Boolean

        ' Attempt to open the named mutex.
        Try
            ' Open the mutex with (MutexRights.Synchronize Or
            ' MutexRights.Modify), to enter and release the
            ' named mutex.
            '
            m = Mutex.OpenExisting(mutexName)
        Catch ex As WaitHandleCannotBeOpenedException
            Console.WriteLine("Mutex does not exist.")
            doesNotExist = True
        Catch ex As UnauthorizedAccessException
            Console.WriteLine("Unauthorized access: {0}", ex.Message)
            unauthorized = True
        End Try

        ' There are three cases: (1) The mutex does not exist.
        ' (2) The mutex exists, but the current user doesn't 
        ' have access. (3) The mutex exists and the user has
        ' access.
        '
        If doesNotExist Then
            ' The mutex does not exist, so create it.

            ' Create an access control list (ACL) that denies the
            ' current user the right to enter or release the 
            ' mutex, but allows the right to read and change
            ' security information for the mutex.
            '
            Dim user As String = Environment.UserDomainName _ 
                & "\" & Environment.UserName
            Dim mSec As New MutexSecurity()

            Dim rule As New MutexAccessRule(user, _
                MutexRights.Synchronize Or MutexRights.Modify, _
                AccessControlType.Deny)
            mSec.AddAccessRule(rule)

            rule = New MutexAccessRule(user, _
                MutexRights.ReadPermissions Or _
                MutexRights.ChangePermissions, _
                AccessControlType.Allow)
            mSec.AddAccessRule(rule)

            ' Create a Mutex object that represents the system
            ' mutex named by the constant 'mutexName', with
            ' initial ownership for this thread, and with the
            ' specified security access. The Boolean value that 
            ' indicates creation of the underlying system object
            ' is placed in mutexWasCreated.
            '
            m = New Mutex(True, mutexName, mutexWasCreated, mSec)

            ' If the named system mutex was created, it can be
            ' used by the current instance of this program, even 
            ' though the current user is denied access. The current
            ' program owns the mutex. Otherwise, exit the program.
            ' 
            If mutexWasCreated Then
                Console.WriteLine("Created the mutex.")
            Else
                Console.WriteLine("Unable to create the mutex.")
                Return
            End If

        ElseIf unauthorized Then

            ' Open the mutex to read and change the access control
            ' security. The access control security defined above
            ' allows the current user to do this.
            '
            Try
                m = Mutex.OpenExisting(mutexName, _
                    MutexRights.ReadPermissions Or _
                    MutexRights.ChangePermissions)

                ' Get the current ACL. This requires 
                ' MutexRights.ReadPermissions.
                Dim mSec As MutexSecurity = m.GetAccessControl()
                
                Dim user As String = Environment.UserDomainName _ 
                    & "\" & Environment.UserName

                ' First, the rule that denied the current user 
                ' the right to enter and release the mutex must
                ' be removed.
                Dim rule As New MutexAccessRule(user, _
                    MutexRights.Synchronize Or MutexRights.Modify, _
                    AccessControlType.Deny)
                mSec.RemoveAccessRule(rule)

                ' Now grant the user the correct rights.
                ' 
                rule = New MutexAccessRule(user, _
                    MutexRights.Synchronize Or MutexRights.Modify, _
                    AccessControlType.Allow)
                mSec.AddAccessRule(rule)

                ' Update the ACL. This requires
                ' MutexRights.ChangePermissions.
                m.SetAccessControl(mSec)

                Console.WriteLine("Updated mutex security.")

                ' Open the mutex with (MutexRights.Synchronize 
                ' Or MutexRights.Modify), the rights required to
                ' enter and release the mutex.
                '
                m = Mutex.OpenExisting(mutexName)

            Catch ex As UnauthorizedAccessException
                Console.WriteLine("Unable to change permissions: {0}", _
                    ex.Message)
                Return
            End Try

        End If

        ' If this program created the mutex, it already owns
        ' the mutex.
        '
        If Not mutexWasCreated Then
            ' Enter the mutex, and hold it until the program
            ' exits.
            '
            Try
                Console.WriteLine("Wait for the mutex.")
                m.WaitOne()
                Console.WriteLine("Entered the mutex.")
            Catch ex As UnauthorizedAccessException
                Console.WriteLine("Unauthorized access: {0}", _
                    ex.Message)
            End Try
        End If

        Console.WriteLine("Press the Enter key to exit.")
        Console.ReadLine()
        m.ReleaseMutex()
        m.Dispose()
    End Sub 
End Class

Комментарии

Может name быть префиксирован или Global\Local\ указано пространство имен. Global При указании пространства имен объект синхронизации может быть предоставлен совместно с любыми процессами в системе. Local Если указано пространство имен, которое также является значением по умолчанию, если пространство имен не указано, объект синхронизации может быть предоставлен совместно с процессами в одном сеансе. В Windows сеанс является сеансом входа, а службы обычно выполняются в другом неинтерактивном сеансе. В операционных системах, таких как Unix, каждая оболочка имеет свой собственный сеанс. Объекты локальной синхронизации сеанса могут быть подходящими для синхронизации между процессами с отношением родительского или дочернего, где все они выполняются в одном сеансе. Дополнительные сведения о именах объектов синхронизации в Windows см. в разделе Object Names.

name Если указан и объект синхронизации запрошенного типа уже существует в пространстве имен, используется существующий объект синхронизации. Если объект синхронизации другого типа уже существует в пространстве имен, WaitHandleCannotBeOpenedException создается исключение. В противном случае создается новый объект синхронизации.

Если name это не так nullinitiallyOwnedtrue, вызывающий поток владеет именованным мьютексом, только если createdNew после true вызова. В противном случае поток может запросить мьютекс, вызвав WaitOne метод.

Используйте этот конструктор, чтобы применить безопасность управления доступом к именованным системным мьютексу при его создании, предотвращая контроль над другим кодом.

Этот конструктор инициализирует Mutex объект, представляющий именованный системный мьютекс. Можно создать несколько Mutex объектов, представляющих один и тот же именованный системный мьютекс.

Если именованный системный мьютекс не существует, он создается с указанной безопасностью управления доступом. Если именованный мьютекс существует, то указанная безопасность управления доступом игнорируется.

Note

Вызывающий объект имеет полный контроль над вновь созданным Mutex объектом, даже если mutexSecurity запрещает или не предоставляет некоторые права доступа текущему пользователю. Однако если текущий пользователь пытается получить другой объект Mutex для представления того же именованного мьютекса, используя конструктор или метод OpenExisting, применяется Windows безопасность управления доступом.

Если именованный мьютекс уже создан с безопасностью управления доступом и вызывающий объект не имеет MutexRights.FullControl, создается исключение. Чтобы открыть существующий именованный мьютекс только с этими разрешениями, необходимыми для синхронизации действий потока, см. в этом методе OpenExisting .

Если задана null или пустая строка для name, создается локальный мьютекс, как если бы вы вызвали Mutex(Boolean) конструктор. В этом случае createdNew всегда true.

Так как они являются системными, именованные мьютексы можно использовать для координации использования ресурсов через границы процесса.

Note

На сервере, на котором выполняются службы терминалов, именованный системный мьютекс может иметь два уровня видимости. Если его имя начинается с префикса Global\, мьютекс отображается во всех сеансах сервера терминала. Если его имя начинается с префикса Local\, мьютекс отображается только в сеансе сервера терминала, где он был создан. В этом случае отдельный мьютекс с тем же именем может существовать в каждом из других сеансов сервера терминала на сервере. Если при создании именованного мьютекса не указан префикс, он принимает префикс Local\. В сеансе сервера терминала два мьютекса, имена которых отличаются только по их префиксам, являются отдельными мьютексами, и оба являются видимыми для всех процессов в сеансе сервера терминала. То есть имена Global\ префиксов и Local\ описание области имени мьютекса относительно сеансов сервера терминала, а не относительно процессов.

Предостережение

По умолчанию именованный мьютекс не ограничивается пользователем, создающим его. Другие пользователи могут открывать и использовать мьютекс, включая вмешательство в мьютекс, вводя мьютекс и не выходя из него. Чтобы ограничить доступ к определенным пользователям, можно передать его MutexSecurity при создании именованного мьютекса. Избегайте использования именованных мьютексов без ограничений доступа в системах, которые могут иметь ненадежных пользователей, выполняющих код.

Обратная косая черта (\) — это зарезервированный символ в имени мьютекса. Не используйте обратную косую черту (\) в имени мьютекса, за исключением указанного в заметке об использовании мьютексов в сеансах сервера терминалов. В противном случае может возникать исключение, DirectoryNotFoundException даже если имя мьютекса представляет существующий файл.

Применяется к

Mutex(Boolean, String, NamedWaitHandleOptions, Boolean)

Исходный код:
Mutex.cs
Исходный код:
Mutex.cs

Инициализирует новый экземпляр Mutex класса с логическим значением, указывающим, должен ли вызывающий поток иметь начальное владение мьютексом, строка, представляющая имя мьютекса, параметры для задания доступа к области пользователя и области сеанса, а также логическое значение, которое, когда метод возвращает, указывает, был ли вызывающий поток предоставлен начальное владение мьютексом.

public:
 Mutex(bool initiallyOwned, System::String ^ name, System::Threading::NamedWaitHandleOptions options, [Runtime::InteropServices::Out] bool % createdNew);
public Mutex(bool initiallyOwned, string? name, System.Threading.NamedWaitHandleOptions options, out bool createdNew);
new System.Threading.Mutex : bool * string * System.Threading.NamedWaitHandleOptions * bool -> System.Threading.Mutex
Public Sub New (initiallyOwned As Boolean, name As String, options As NamedWaitHandleOptions, ByRef createdNew As Boolean)

Параметры

initiallyOwned
Boolean

true , чтобы предоставить вызову первоначальное владение именованным системным мьютексом, если именованный системный мьютекс создается в результате этого вызова; falseв противном случае .

name
String

Имя, если объект синхронизации должен использоваться совместно с другими процессами; null в противном случае или пустая строка. Имя чувствительно к регистру.

options
NamedWaitHandleOptions

Параметры области именованного системного мьютекса. По умолчанию доступ ограничен текущим пользователем и текущим сеансом. Указанные параметры могут повлиять на пространство имен для имени и доступа к базовому объекту мьютекса системы.

createdNew
Boolean

При возврате этого метода содержит логическое значение, которое true указывает, был ли создан локальный мьютекс (т name . е. если строка null или пустая строка) или если был создан указанный именованный системный мьютекс; содержит false , если указанный именованный системный мьютекс уже существует. Этот параметр передается неинициализирован.

Исключения

UnauthorizedAccessException

Именованный мьютекс существует и имеет безопасность управления доступом, но у пользователя нет FullControl.

IOException

name недопустим. Это может быть по разным причинам, включая некоторые ограничения, которые могут быть помещены операционной системой, например неизвестный префикс или недопустимые символы. Обратите внимание, что имя и распространенные префиксы "Global\" и "Local\" чувствительны к регистру.

–или–

Произошла другая ошибка. Свойство HResult может предоставить дополнительные сведения.

DirectoryNotFoundException

Windows только: name указало неизвестное пространство имен. Дополнительные сведения см. в разделе "Имена объектов ".

PathTooLongException

Слишком длинное значение name. Ограничения длины могут зависеть от операционной системы или конфигурации.

WaitHandleCannotBeOpenedException

Не удается создать объект синхронизации с предоставленным name объектом. Объект синхронизации другого типа может иметь то же имя. –или–

Объект с указанным name существует, но указанный options не совместим с параметрами существующего объекта.

Комментарии

name Если указан объект синхронизации запрошенного типа уже существует в пространстве имен, то используется существующий объект синхронизации, однако если options указан доступ, ограниченный текущим пользователем, а объект синхронизации несовместим с ним, WaitHandleCannotBeOpenedException создается исключение. Если объект синхронизации другого типа уже существует в пространстве имен, WaitHandleCannotBeOpenedException создается также. В противном случае создается новый объект синхронизации.

Если name это не так nullinitiallyOwnedtrue, вызывающий поток владеет именованным мьютексом, только если createdNew после true вызова. В противном случае поток может запросить мьютекс, вызвав WaitOne метод.

Этот конструктор инициализирует Mutex объект, представляющий именованный системный мьютекс. Можно создать несколько Mutex объектов, представляющих один и тот же именованный системный мьютекс.

Если именованный мьютекс уже создан с безопасностью управления доступом и вызывающий не имеет MutexRights.FullControl прав, создается исключение. Чтобы открыть существующий именованный мьютекс только с этими разрешениями, необходимыми для синхронизации действий потока, см. в этом методе OpenExisting .

Если задана null или пустая строка для name, создается локальный мьютекс, как если бы вы вызвали Mutex(Boolean) конструктор. В этом случае createdNew всегда true.

Так как они являются системными, именованные мьютексы можно использовать для координации использования ресурсов через границы процесса.

Этот options параметр можно указать, доступен ли именованный мьютекс текущему пользователю только или всем пользователям. Он также позволяет указать, доступен ли именованный мьютекс для процессов только в текущем сеансе или ко всем сеансам. Дополнительные сведения см. в разделе NamedWaitHandleOptions.

См. также раздел

Применяется к