MutexSecurity.RemoveAccessRule(MutexAccessRule) Yöntem

Tanım

Ad Alanı:

System.Security.AccessControl

Bütünleştirilmiş Kod:

System.Threading.AccessControl.dll

Paket:

System.Threading.AccessControl v9.0.0-preview.6.24327.7

Kaynak:

MutexSecurity.cs

Belirtilen kuralla aynı kullanıcı ve AccessControlType (izin ver veya reddet) ile uyumlu devralma ve yayma bayraklarıyla bir erişim denetimi kuralı arar; böyle bir kural bulunursa, belirtilen erişim kuralında yer alan haklar bu kuraldan kaldırılır.

public:
 bool RemoveAccessRule(System::Security::AccessControl::MutexAccessRule ^ rule);

public bool RemoveAccessRule (System.Security.AccessControl.MutexAccessRule rule);

override this.RemoveAccessRule : System.Security.AccessControl.MutexAccessRule -> bool

Public Function RemoveAccessRule (rule As MutexAccessRule) As Boolean

Parametreler

rule

MutexAccessRule

MutexAccessRule Kullanıcı ve AccessControlType aranacak öğesini belirten ve bir dizi devralma ve yayma bayrağı bulunan bir eşleşen kuralın uyumlu olması gerekir. Bulunursa uyumlu kuraldan kaldırılacak hakları belirtir.

Döndürülenler

Boolean

true uyumlu bir kural bulunursa; aksi takdirde false.

Özel durumlar

ArgumentNullException

rule, null değeridir.

Örnekler

Aşağıdaki kod örneği, bir nesnedeki RemoveAccessRule bir Allow kuraldan MutexSecurity hakları kaldırmak için yönteminin kullanımını gösterir. Ayrıca içindeki rule diğer hakların yoksayıldığını da gösterir.

Örnek bir MutexSecurity nesne oluşturur ve geçerli kullanıcı için çeşitli haklara izin veren ve reddeden kurallar ekler. İzin verilen haklar arasında Modify, ReadPermissionsve Synchronizebulunur. Örnek daha sonra geçerli kullanıcı için ve TakeOwnership hakları dahil olmak üzere ReadPermissions yeni bir kural oluşturur ve bu kuralı nesnesindeki RemoveAccessRule kuraldan MutexSecurityAllow kaldırmak ReadPermissions için yöntemiyle birlikte kullanır. içindeki fazlalık TakeOwnership hakkı rule yoksayılır.

Not

Bu örnek, güvenlik nesnesini bir Mutex nesneye eklemez. Güvenlik nesnelerini ekleyen örnekler ve Mutex.SetAccessControliçinde Mutex.GetAccessControl bulunabilir.

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 and read the
        // permissions on the mutex.
        MutexAccessRule rule = new MutexAccessRule(user, 
            MutexRights.Synchronize | MutexRights.Modify
                | MutexRights.ReadPermissions, 
            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);

        // Create a rule that grants the current user 
        // the right to read permissions on the mutex, and
        // take ownership of the mutex. Use this rule to 
        // remove the right to read permissions from the 
        // Allow rule for the current user. The inclusion 
        // of the right to take ownership has no effect.
        rule = new MutexAccessRule(user, 
            MutexRights.TakeOwnership | 
                MutexRights.ReadPermissions, 
            AccessControlType.Allow);
        mSec.RemoveAccessRule(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, ReadPermissions, Synchronize


Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, 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, and to 
        ' read its permissions.
        Dim rule As New MutexAccessRule(user, _
            MutexRights.Synchronize _
            Or MutexRights.Modify _
            Or MutexRights.ReadPermissions, _
            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)

        ' Create a rule that grants the current user 
        ' the right to read permissions on the mutex, and
        ' take ownership of the mutex. Use this rule to 
        ' remove the right to read permissions from the 
        ' Allow rule for the current user. The inclusion 
        ' of the right to take ownership has no effect.
        rule = New MutexAccessRule(user, _
            MutexRights.TakeOwnership _
            Or MutexRights.ReadPermissions, _
            AccessControlType.Allow)
        mSec.RemoveAccessRule(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, ReadPermissions, Synchronize
'
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, Synchronize

Açıklamalar

Geçerli MutexSecurity , aynı kullanıcıya ve ile aynı AccessControlType değere rulesahip bir kural için arandı. Böyle bir kural bulunmazsa hiçbir eylem yapılmaz ve yöntemi döndürür false. Eşleşen kurallar bulunursa, devralma ve uyumluluk bayrakları içinde rulebelirtilen bayraklarla uyumluluk açısından denetlenirse. Uyumlu bir kural bulunamazsa hiçbir eylem yapılmaz ve yöntemi döndürür false. Uyumlu bayraklara sahip bir kural bulunursa, içinde rule belirtilen haklar uyumlu kuraldan kaldırılır ve yöntemi döndürür true. Uyumlu kuralda yer alan hakları belirtirse rule , bu haklarla ilgili hiçbir işlem yapılmaz. Tüm haklar uyumlu kuraldan kaldırılırsa, kuralın tamamı geçerli MutexSecurity nesneden kaldırılır.

Önemli

Mutex erişim kuralları için devralma ve yayma bayrakları belirtebilse de, bunları yöntemiyle AccessRuleFactory oluşturarak bu önerilmez. Devralma ve yayma, adlandırılmış mutex'ler için bir anlam ifade etmez ve erişim kurallarının bakımını daha karmaşık hale getirir.