MutexAccessRule Класс

Определение

Пространство имен:

System.Security.AccessControl

Сборка:

System.Threading.AccessControl.dll

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

public ref class MutexAccessRule sealed : System::Security::AccessControl::AccessRule

public sealed class MutexAccessRule : System.Security.AccessControl.AccessRule

type MutexAccessRule = class
    inherit AccessRule

Public NotInheritable Class MutexAccessRule
Inherits AccessRule

Наследование

Object

AuthorizationRule

AccessRule

MutexAccessRule

Примеры

В следующем примере кода показано создание и использование MutexAccessRule объектов. В примере создается MutexSecurity объект, добавляются правила, которые разрешают и запрещают различные права для текущего пользователя, и отображаются результирующая пара правил. Затем в примере разрешены новые права для текущего пользователя и отображается результат, показывающий, что новые права объединяются с существующим Allow правилом.

Замечание

Этот пример не присоединяет объект безопасности к объекту Mutex . Примеры подключения объектов безопасности можно найти в Mutex.GetAccessControl и Mutex.SetAccessControl.

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

public class Example
{
    public static void Main()
    {
        // Create a string representing the current user.
        string user = Environment.UserDomainName + "\\" + 
            Environment.UserName;

        // Create a security object that grants no access.
        MutexSecurity mSec = new MutexSecurity();

        // Add a rule that grants the current user the 
        // right to enter or release the mutex.
        MutexAccessRule rule = new MutexAccessRule(user, 
            MutexRights.Synchronize | MutexRights.Modify, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        // Add a rule that denies the current user the 
        // right to change permissions on the mutex.
        rule = new MutexAccessRule(user, 
            MutexRights.ChangePermissions, 
            AccessControlType.Deny);
        mSec.AddAccessRule(rule);

        // Display the rules in the security object.
        ShowSecurity(mSec);

        // Add a rule that allows the current user the 
        // right to read permissions on the mutex. This rule
        // is merged with the existing Allow rule.
        rule = new MutexAccessRule(user, 
            MutexRights.ReadPermissions, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        ShowSecurity(mSec);
    }

    private static void ShowSecurity(MutexSecurity security)
    {
        Console.WriteLine("\r\nCurrent access rules:\r\n");

        foreach(MutexAccessRule ar in 
            security.GetAccessRules(true, true, typeof(NTAccount)))
        {
            Console.WriteLine("        User: {0}", ar.IdentityReference);
            Console.WriteLine("        Type: {0}", ar.AccessControlType);
            Console.WriteLine("      Rights: {0}", ar.MutexRights);
            Console.WriteLine();
        }
    }
}

/*This code example produces output similar to following:

Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, Synchronize


Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, ReadPermissions, Synchronize
 */

Imports System.Threading
Imports System.Security.AccessControl
Imports System.Security.Principal

Public Class Example

    Public Shared Sub Main()

        ' Create a string representing the current user.
        Dim user As String = Environment.UserDomainName _ 
            & "\" & Environment.UserName

        ' Create a security object that grants no access.
        Dim mSec As New MutexSecurity()

        ' Add a rule that grants the current user the 
        ' right to enter or release the mutex.
        Dim rule As New MutexAccessRule(user, _
            MutexRights.Synchronize _
            Or MutexRights.Modify, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ' Add a rule that denies the current user the 
        ' right to change permissions on the mutex.
        rule = New MutexAccessRule(user, _
            MutexRights.ChangePermissions, _
            AccessControlType.Deny)
        mSec.AddAccessRule(rule)

        ' Display the rules in the security object.
        ShowSecurity(mSec)

        ' Add a rule that allows the current user the 
        ' right to read permissions on the mutex. This rule
        ' is merged with the existing Allow rule.
        rule = New MutexAccessRule(user, _
            MutexRights.ReadPermissions, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ShowSecurity(mSec)

    End Sub 

    Private Shared Sub ShowSecurity(ByVal security As MutexSecurity)
        Console.WriteLine(vbCrLf & "Current access rules:" & vbCrLf)

        For Each ar As MutexAccessRule In _
            security.GetAccessRules(True, True, GetType(NTAccount))

            Console.WriteLine("        User: {0}", ar.IdentityReference)
            Console.WriteLine("        Type: {0}", ar.AccessControlType)
            Console.WriteLine("      Rights: {0}", ar.MutexRights)
            Console.WriteLine()
        Next

    End Sub
End Class 

'This code example produces output similar to following:
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, Synchronize
'
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, ReadPermissions, Synchronize

Комментарии

Замечание

Этот тип поддерживается только в Windows.

Класс MutexAccessRule является одним из наборов классов, которые платформа .NET Framework предоставляет для управления безопасностью управления доступом Windows в именованных системных мьютексах. Общие сведения об этих классах и их отношениях с базовыми структурами управления доступом Windows см. в разделе MutexSecurity.

Замечание

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

Чтобы получить список правил, применяемых к именованным мьютексу, используйте Mutex.GetAccessControl метод для получения MutexSecurity объекта, а затем используйте его GetAccessRules метод для получения коллекции MutexAccessRule объектов.

MutexAccessRule объекты не сопоставляются с записями управления доступом в базовом списке управления доступом (DACL). При получении набора всех правил доступа для мьютекса набор содержит минимальное количество правил, необходимых для выражения всех записей управления доступом.

Замечание

Базовые записи управления доступом изменяются при применении и удалении правил. Сведения в правилах объединяются, если это возможно, для поддержания наименьшего количества записей управления доступом. Таким образом, при чтении текущего списка правил он может не выглядеть точно так же, как список всех добавленных правил.

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

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

Это важно

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

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

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

Имя	Описание
MutexAccessRule(IdentityReference, MutexRights, AccessControlType)	Инициализирует новый экземпляр MutexAccessRule класса, указывая пользователя или группу, к которым применяется правило, права доступа и разрешены ли указанные права доступа или запрещены.
MutexAccessRule(String, MutexRights, AccessControlType)	Инициализирует новый экземпляр MutexAccessRule класса, указывая имя пользователя или группы, к которым применяется правило, права доступа и разрешены ли указанные права доступа или запрещены.

Свойства

Имя	Описание
AccessControlType	Возвращает значение, связанное AccessControlType с этим AccessRule объектом. (Унаследовано от AccessRule)
AccessMask	Возвращает маску доступа для этого правила. (Унаследовано от AuthorizationRule)
IdentityReference	Возвращает значение IdentityReference , к которому применяется это правило. (Унаследовано от AuthorizationRule)
InheritanceFlags	Получает значение флагов, определяющих, как это правило наследуется дочерними объектами. (Унаследовано от AuthorizationRule)
IsInherited	Возвращает значение, указывающее, задано ли это правило явным образом или наследуется от родительского объекта контейнера. (Унаследовано от AuthorizationRule)
MutexRights	Возвращает права, разрешенные или запрещенные правилом доступа.
PropagationFlags	Возвращает значение флагов распространения, определяющих, как наследование этого правила распространяется на дочерние объекты. Это свойство имеет значение, только если значение перечисления InheritanceFlags не Noneявляется. (Унаследовано от AuthorizationRule)

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Type Возвращает текущий экземпляр. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• MutexSecurity