Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

MutexRights-Enumeration

Aktualisiert: November 2007

Gibt die Zugriffssteuerungsrechte an, die auf benannte Systemmutexobjekte angewendet werden können.

Diese Enumeration verfügt über ein FlagsAttribute-Attribut, das die bitweise Kombination der Memberwerte zulässt.

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

[FlagsAttribute]
public enum MutexRights
/** @attribute FlagsAttribute */
public enum MutexRights
public enum MutexRights

MembernameBeschreibung
ModifyDas Recht, einen benannten Mutex freizugeben.
DeleteDas Recht, einen benannten Mutex zu löschen.
ReadPermissionsDas Recht, die Zugriffsregeln und die Überwachungsregeln eines benannten Mutex zu öffnen und zu kopieren.
ChangePermissionsDas Recht, die dem benannten Mutex zugeordneten Sicherheits- und Überwachungsregeln zu ändern.
TakeOwnershipDas Recht, den Besitzer eines benannten Mutex zu ändern.
SynchronizeDas Recht, auf einen benannten Mutex zu warten.
FullControlDas Recht, die vollständige Kontrolle über einen benannten Mutex auszuüben und seine Zugriffsregeln und Überwachungsregeln zu ändern.

Geben Sie mit der MutexRights-Enumeration die Zugriffssteuerungsrechte an, wenn Sie MutexSecurity-Objekte erstellen. Um Zugriffsrechte auf einen benannten Systemmutex anzuwenden, verwenden Sie MutexSecurity-Objekte mit dem Mutex(Boolean, String, Boolean, MutexSecurity)-Konstruktor und der Mutex.SetAccessControl-Methode.

ha22eb0e.alert_note(de-de,VS.90).gifHinweis:

Sicherheit wird für Synchronisierungsobjekte für Windows 98 oder Windows Millennium Edition nicht unterstützt.

Im folgenden Codebeispiel wird die Verwendung von MutexRights-Werten beim Erstellen und Verwenden von MutexAccessRule-Objekten veranschaulicht. Im Beispiel wird ein MutexSecurity-Objekt erstellt. Außerdem werden Regeln hinzugefügt, die dem aktuellen Benutzer eine Reihe von Rechten gewähren und verweigern, und das sich ergebende Regelpaar wird angezeigt. Anschließend werden dem aktuellen Benutzer im Beispiel neue Rechte gewährt, und es wird das Ergebnis angezeigt, das die Zusammenführung der neuen Rechte mit der vorhandenen AccessControlType.Allow-Regel darstellt.

ha22eb0e.alert_note(de-de,VS.90).gifHinweis:

In diesem Beispiel wird das Sicherheitsobjekt nicht an ein Mutex-Objekt angefügt, siehe MutexSecurity, Mutex.GetAccessControl-Methode 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.
        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
 */


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0
Anzeigen: