MutexAccessRule Třída

Definice

Obor názvů:

System.Security.AccessControl

Sestavení:

System.Threading.AccessControl.dll

Představuje sadu přístupových práv povolených nebo zakázaných pro uživatele nebo skupinu. Tuto třídu nelze zdědit.

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

Dědičnost

Object

AuthorizationRule

AccessRule

MutexAccessRule

Příklady

Následující příklad kódu ukazuje vytvoření a použití MutexAccessRule objektů. Příklad vytvoří MutexSecurity objekt, přidá pravidla, která povolují a zakazují různá práva pro aktuálního uživatele, a zobrazí výslednou dvojici pravidel. Příklad pak povolí nová práva pro aktuálního uživatele a zobrazí výsledek, který ukazuje, že nová práva jsou sloučena s existujícím Allow pravidlem.

Poznámka:

Tento příklad nepřipokládá objekt zabezpečení k objektu Mutex . Příklady, které připojují objekty zabezpečení, lze najít v Mutex.GetAccessControl a 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

Poznámky

Poznámka:

Tento typ je podporován pouze ve Windows.

Třída MutexAccessRule je jednou ze sady tříd, které rozhraní .NET Framework poskytuje pro správu zabezpečení řízení přístupu systému Windows na pojmenovaných mutexech systému. Přehled těchto tříd a jejich vztah k podkladovým strukturám řízení přístupu systému Windows naleznete v tématu MutexSecurity.

Poznámka:

Zabezpečení řízení přístupu systému Windows je smysluplné pouze pro pojmenované systémové mutexy. Mutex Pokud objekt představuje místní mutex, řízení přístupu je irelevantní.

Chcete-li získat seznam pravidel aktuálně použitých pro pojmenovaný mutex, použijte metodu Mutex.GetAccessControl k získání objektu MutexSecurity a pak pomocí jeho GetAccessRules metody získejte kolekci MutexAccessRule objektů.

MutexAccessRule objekty nemapují 1:1 s položkami řízení přístupu v podkladovém volitelném seznamu řízení přístupu (DACL). Když získáte sadu všech pravidel přístupu pro mutex, sada obsahuje minimální počet pravidel, která jsou aktuálně nutná k vyjádření všech položek řízení přístupu.

Poznámka:

Související položky řízení přístupu se mění při použití a odebírání pravidel. Pokud je to možné, informace v pravidlech se sloučí, aby se zachoval nejmenší počet položek řízení přístupu. Proto při čtení aktuálního seznamu pravidel nemusí vypadat přesně jako seznam všech pravidel, která jste přidali.

Pomocí MutexAccessRule objektů můžete určit přístupová práva k povolení nebo zamítnutí uživateli nebo skupině. Objekt MutexAccessRule vždy představuje buď povolený přístup, nebo odepřený přístup, nikdy obojí.

Chcete-li použít pravidlo na pojmenovaný systémový mutex, použijte Mutex.GetAccessControl metodu k získání objektu MutexSecurity . MutexSecurity Upravte objekt pomocí svých metod pro přidání pravidla a pak použijte metodu Mutex.SetAccessControl k opětovnému připojení objektu zabezpečení.

Důležité

Změny provedené v objektu MutexSecurity nemají vliv na úrovně přístupu pojmenovaného mutex, dokud nezavoláte metodu Mutex.SetAccessControl , která přiřadí změněný objekt zabezpečení pojmenované mutex.

MutexAccessRule objekty jsou neměnné. Zabezpečení pro mutex je změněno pomocí metod MutexSecurity třídy pro přidání nebo odebrání pravidel; jak to uděláte, podkladové položky řízení přístupu jsou změněny.

Konstruktory

Name	Description
MutexAccessRule(IdentityReference, MutexRights, AccessControlType)	Inicializuje novou instanci MutexAccessRule třídy, určuje uživatele nebo skupinu, na které se pravidlo vztahuje, přístupová práva a zda jsou zadaná přístupová práva povolena nebo odepřena.
MutexAccessRule(String, MutexRights, AccessControlType)	Inicializuje novou instanci MutexAccessRule třídy, určuje název uživatele nebo skupiny, na které se pravidlo vztahuje, přístupová práva a zda jsou zadaná přístupová práva povolena nebo odepřena.

Vlastnosti

Name	Description
AccessControlType	Získá hodnotu přidruženou AccessControlType k tomuto AccessRule objektu. (Zděděno od AccessRule)
AccessMask	Získá přístupová maska pro toto pravidlo. (Zděděno od AuthorizationRule)
IdentityReference	Získá, IdentityReference na které se toto pravidlo vztahuje. (Zděděno od AuthorizationRule)
InheritanceFlags	Získá hodnotu příznaků, které určují, jak je toto pravidlo zděděno podřízenými objekty. (Zděděno od AuthorizationRule)
IsInherited	Získá hodnotu určující, zda je toto pravidlo explicitně nastaveno nebo je zděděno z nadřazeného objektu kontejneru. (Zděděno od AuthorizationRule)
MutexRights	Získá práva povolená nebo odepřena pravidlem přístupu.
PropagationFlags	Získá hodnotu příznaky šíření, které určují, jak dědičnost tohoto pravidla je rozšířena na podřízené objekty. Tato vlastnost je významná pouze v případě, že hodnota výčtu InheritanceFlags není None. (Zděděno od AuthorizationRule)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• MutexSecurity