MutexAccessRule Osztály

Definíció

Névtér:

System.Security.AccessControl

Szerelvény:

System.Threading.AccessControl.dll

Csomag:

System.Threading.AccessControl v11.0.0-rc.1.26425.128

Forrás:

MutexSecurity.cs

Egy felhasználó vagy csoport számára engedélyezett vagy elutasított hozzáférési jogosultságokat jelöl. Ez az osztály nem örökölhető.

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

Öröklődés

Object

AuthorizationRule

AccessRule

MutexAccessRule

Példák

Az alábbi példakód az objektumok létrehozását és használatát MutexAccessRule mutatja be. A példa létrehoz egy MutexSecurity objektumot, olyan szabályokat ad hozzá, amelyek különböző jogosultságokat engedélyeznek és tiltanak az aktuális felhasználó számára, és megjeleníti az eredményként kapott szabálypárt. A példa ezután új jogosultságokat engedélyez az aktuális felhasználó számára, és megjeleníti az eredményt, amely azt mutatja, hogy az új jogosultságok egyesülnek a meglévő Allow szabvánnyal.

Note

Ez a példa nem csatolja a biztonsági objektumot egy Mutex objektumhoz. A biztonsági objektumokat csatoló példák a következő helyen Mutex.GetAccessControl találhatók: és 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

Megjegyzések

Note

Ez a típus csak Windows támogatott.

A MutexAccessRule osztály egyike azon osztályoknak, amelyeket a .NET-keretrendszer biztosít Windows hozzáférés-vezérlési biztonság kezelésére a nevesített rendszer mutexeken. Ezekről az osztályokról és a mögöttes Windows hozzáférés-vezérlési struktúrákhoz való viszonyukról a MutexSecurity című cikkben olvashat.

Note

Windows hozzáférés-vezérlés biztonsága csak a nevesített rendszer-mutexek esetében értelmezhető. Ha egy Mutex objektum helyi mutexet jelöl, a hozzáférés-vezérlés irreleváns.

A névvel ellátott mutexre jelenleg alkalmazott szabályok listájának lekéréséhez használja a Mutex.GetAccessControl metódust egy MutexSecurity objektum lekérésére GetAccessRules , majd a metódus használatával szerezze be az objektumok gyűjteményét MutexAccessRule .

MutexAccessRule az objektumok nem képeznek le egy-az-egyhez hozzáférés-vezérlési bejegyzéseket a mögöttes diszkréciós hozzáférés-vezérlési listában (DACL). Amikor lekéri egy mutex összes hozzáférési szabályát, a készlet tartalmazza az összes hozzáférés-vezérlési bejegyzés kifejezéséhez jelenleg szükséges minimális számú szabályt.

Note

A mögöttes hozzáférés-vezérlési bejegyzések a szabályok alkalmazásakor és eltávolításakor változnak. A szabályok információi lehetőség szerint egyesítve lesznek a hozzáférés-vezérlési bejegyzések legkisebb számának fenntartása érdekében. Így ha elolvassa az aktuális szabálylistát, az nem feltétlenül hasonlít az összes hozzáadott szabály listájára.

Objektumokkal MutexAccessRule adhatja meg a hozzáférési jogosultságokat, amelyek lehetővé teszik vagy megtagadják a felhasználók vagy csoportok számára. Az MutexAccessRule objektumok mindig az engedélyezett vagy a megtagadott hozzáférést jelölik, mindkettőt soha.

Ha egy szabályt egy elnevezett rendszer-mutexre szeretne alkalmazni, használja a Mutex.GetAccessControl metódust az objektum lekéréséhez MutexSecurity . Módosítsa az objektumot a MutexSecurity metódusok használatával a szabály hozzáadásához, majd használja a Mutex.SetAccessControl metódust a biztonsági objektum újraaktiválásához.

Important

Az objektumon MutexSecurity végzett módosítások nem befolyásolják a névvel ellátott mutex hozzáférési szintjeire, amíg meg nem hívja a Mutex.SetAccessControl metódust, hogy a módosított biztonsági objektumot rendelje hozzá a névvel ellátott mutexhez.

MutexAccessRule objektumok nem módosíthatók. A rendszer módosítja a mutexek biztonságát az osztály metódusaival MutexSecurity a szabályok hozzáadásához vagy eltávolításához. Ennek során a mögöttes hozzáférés-vezérlési bejegyzések módosulnak.

Konstruktorok

Name	Description
MutexAccessRule(IdentityReference, MutexRights, AccessControlType)	Inicializálja az MutexAccessRule osztály új példányát, megadva azt a felhasználót vagy csoportot, akire a szabály vonatkozik, a hozzáférési jogosultságokat, valamint azt, hogy a megadott hozzáférési jogosultságok engedélyezettek vagy megtagadhatók-e.
MutexAccessRule(String, MutexRights, AccessControlType)	Inicializálja az MutexAccessRule osztály új példányát, megadva annak a felhasználónak vagy csoportnak a nevét, akire a szabály vonatkozik, a hozzáférési jogosultságokat, valamint azt, hogy a megadott hozzáférési jogosultságok engedélyezettek vagy megtagadhatók-e.

Tulajdonságok

Name	Description
MutexRights	Lekéri a hozzáférési szabály által engedélyezett vagy elutasított jogokat.

Lásd még

• MutexSecurity