Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

MutexSecurity.RemoveAccessRule-Methode (MutexAccessRule)

 

Sucht nach einer Zugriffssteuerungsregel mit demselben Benutzer und demselben AccessControlType (gewähren oder verweigern) wie die angegebene Regel sowie mit kompatiblen Vererbungs- und Weitergabeflags. Wenn eine solche Regel gefunden wird, werden die in der angegebenen Zugriffsregel enthaltenen Rechte daraus entfernt.

Namespace:   System.Security.AccessControl
Assembly:  mscorlib (in mscorlib.dll)

public bool RemoveAccessRule(
	MutexAccessRule rule
)

Parameter

rule

Eine MutexAccessRule, die den Benutzer und den AccessControlType angibt, nach denen gesucht werden soll, sowie eine Reihe von Vererbungs- und Weitergabeflags, mit denen eine übereinstimmende Regel (falls vorhanden) kompatibel sein muss.Gibt die Rechte an, die aus der kompatiblen Regel entfernt werden sollen (falls vorhanden).

Rückgabewert

Type: System.Boolean

true, wenn eine kompatible Regel gefunden wurde, andernfalls false.

Exception Condition
ArgumentNullException

rule ist null.

In der aktuellen MutexSecurity wird nach einer Regel gesucht, die über denselben Benutzer und denselben AccessControlType-Wert wie rule verfügt.Wenn keine derartige Regel gefunden wurde, wird keine Aktion ausgeführt, und die Methode gibt false zurück.Wenn übereinstimmende Regeln gefunden werden, werden ihre Vererbungs- und Kompatibilitätsflags auf Kompatibilität mit den in rule angegebenen Flags überprüft.Wenn keine kompatible Regel gefunden wurde, wird keine Aktion ausgeführt, und die Methode gibt false zurück.Wenn eine Regel mit kompatiblen Flags gefunden wird, werden die in rule angegebenen Rechte aus der kompatiblen Regel entfernt, und die Methode gibt true zurück.Wenn rule Rechte angibt, die nicht in der kompatiblen Regel enthalten sind, werden keine Aktionen in Bezug auf diese Rechte ausgeführt.Wenn alle Rechte aus der kompatiblen Regel entfernt werden, wird die ganze Regel aus dem aktuellen MutexSecurity-Objekt entfernt.

System_CAPS_importantWichtig

Sie können Vererbungs- und Weitergabeflags für Mutex-Zugriffsregeln angeben, indem Sie diese mit der AccessRuleFactory-Methode erstellen. Dies wird jedoch nicht empfohlen.Vererbung und Weitergabe sind für benannte Mutexe bedeutungslos, und sie machen die Verwaltung der Zugriffsregeln nur komplizierter.

Im folgenden Codebeispiel wird die Verwendung der RemoveAccessRule-Methode zum Entfernen von Rechten aus einer Allow-Regel in einem MutexSecurity-Objekt veranschaulicht.Darüber hinaus wird gezeigt, dass andere Rechte in rule ignoriert werden.

Im Beispiel wird ein MutexSecurity-Objekt erstellt, und es werden Regeln hinzugefügt, die dem aktuellen Benutzer verschiedene Rechte gewähren und verweigern.Die folgenden Rechte werden gewährt: Modify, ReadPermissions und Synchronize.Anschließend wird im Beispiel eine neue Regel für den aktuellen Benutzer erstellt, einschließlich des ReadPermissions-Rechts und TakeOwnership-Rechts. Diese Regel wird mit der RemoveAccessRule-Methode verwendet, um ReadPermissions aus der Allow-Regel im MutexSecurity-Objekt zu entfernen.Das TakeOwnership-Recht in rule wird ignoriert.

System_CAPS_noteHinweis

In diesem Beispiel wird das Sicherheitsobjekt nicht an ein Mutex-Objekt angefügt.Beispiele, in denen Sicherheitsobjekte angefügt werden, finden Sie unter Mutex.GetAccessControl und 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 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
 */

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: