MutexAccessRule Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
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

MutexAccessRule-Klasse

 

Stellt eine Gruppe von Zugriffsrechten dar, die einem Benutzer oder einer Gruppe gewährt oder verweigert werden.   Die Klasse erlaubt keine Vererbung.   

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

System.Object
  System.Security.AccessControl.AuthorizationRule
    System.Security.AccessControl.AccessRule
      System.Security.AccessControl.MutexAccessRule

public sealed class MutexAccessRule : AccessRule

NameBeschreibung
System_CAPS_pubmethodMutexAccessRule(IdentityReference, MutexRights, AccessControlType)

Initialisiert eine neue Instanz der MutexAccessRule-Klasse und gibt den Benutzer oder die Gruppe an, für den bzw. die die Regel gilt. Außerdem werden die Zugriffsrechte angegeben und ob diese gewährt oder verweigert werden.

System_CAPS_pubmethodMutexAccessRule(String, MutexRights, AccessControlType)

Initialisiert eine neue Instanz der MutexAccessRule-Klasse und gibt den Namen des Benutzers oder der Gruppe an, für den bzw. die die Regel gilt, sowie die Zugriffsrechte. Außerdem wird angegeben, ob die angegebenen Zugriffsrechte gewährt oder verweigert werden.

NameBeschreibung
System_CAPS_pubpropertyAccessControlType

Ruft den AccessControlType-Wert ab, der diesem AccessRule-Objekt zugeordnet ist.(Geerbt von AccessRule.)

System_CAPS_protpropertyAccessMask

Ruft die Zugriffsmaske für diese Regel ab.(Geerbt von AuthorizationRule.)

System_CAPS_pubpropertyIdentityReference

Ruft den IdentityReference ab, für den diese Regel gilt.(Geerbt von AuthorizationRule.)

System_CAPS_pubpropertyInheritanceFlags

Ruft den Wert von Flags ab, die bestimmen, wie diese Regel von untergeordneten Objekten geerbt wird.(Geerbt von AuthorizationRule.)

System_CAPS_pubpropertyIsInherited

Ruft einen Wert ab, der angibt, ob diese Regel explizit festgelegt oder von einem übergeordneten Containerobjekt geerbt wird.(Geerbt von AuthorizationRule.)

System_CAPS_pubpropertyMutexRights

Ruft die von der Zugriffsregel gewährten oder verweigerten Rechte ab.

System_CAPS_pubpropertyPropagationFlags

Ruft den Wert der Weitergabeflags ab, die bestimmen, wie die Vererbung dieser Regel an untergeordnete Objekte weitergegeben wird. Diese Eigenschaft ist nur dann wesentlich, wenn der Wert der InheritanceFlags-Enumeration nicht None ist.(Geerbt von AuthorizationRule.)

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von Object.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von Object.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von Object.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von Object.)

Die MutexAccessRule-Klasse gehört zu einer von .NET Framework bereitgestellten Gruppe von Klassen zur Verwaltung der Windows-Zugriffssteuerungssicherheit für benannte Systemmutexe.  Eine Übersicht über diese Klassen und ihre Beziehung zu den zugrunde liegenden Windows-Zugriffssteuerungsstrukturen finden Sie unter MutexSecurity.  

System_CAPS_noteHinweis

Die Windows-Zugriffssteuerungssicherheit ist nur für benannte Systemmutexe sinnvoll.  Wenn ein Mutex-Objekt einen lokalen Mutex darstellt, ist die Zugriffssteuerung irrelevant.  

Sie erhalten eine Liste der derzeit auf einen benannten Mutex angewendeten Regeln, indem Sie mit der Mutex.GetAccessControl-Methode ein MutexSecurity-Objekt abrufen und anschließend mit der zugehörigen GetAccessRules-Methode eine Auflistung von MutexAccessRule-Objekten abrufen.

MutexAccessRule-Objekte können Einträgen für die Zugriffssteuerung in der zugrunde liegenden DACL (Discretionary Access Control List, freigegebene Zugriffssteuerungsliste) nicht eins zu eins zugeordnet werden.  Die Gruppe aller für einen Mutex abgerufenen Zugriffsregeln enthält nur die minimale Anzahl von Regeln, die derzeit zur Beschreibung aller Zugriffssteuerungseinträge erforderlich ist.  

System_CAPS_noteHinweis

Die zugrunde liegenden Zugriffssteuerungseinträge ändern sich, wenn Sie Regeln anwenden oder entfernen.  Die Informationen in Regeln werden, wenn möglich, zusammengeführt, um die Anzahl der Zugriffssteuerungseinträge möglichst gering zu halten.  Beim Lesen der aktuellen Regelliste stellen Sie daher möglicherweise Abweichungen gegenüber der Liste aller von Ihnen hinzugefügten Regeln fest.  

Verwenden Sie MutexAccessRule-Objekte, um Zugriffsrechte anzugeben, die einem Benutzer oder einer Gruppe gewährt oder verweigert werden sollen.  Ein MutexAccessRule-Objekt stellt immer entweder einen gewährten oder einen verweigerte Zugriff dar, nie beide.  

Wenden Sie eine Regel auf einen benannten Systemmutex an, indem Sie das MutexSecurity-Objekt mit der Mutex.GetAccessControl-Methode abrufen.  Ändern Sie das MutexSecurity-Objekt, indem Sie mithilfe der zugehörigen Methoden die Regel hinzuzufügen, und verwenden Sie anschließend die Mutex.SetAccessControl-Methode, um das Sicherheitsobjekt erneut anzufügen.  

System_CAPS_importantWichtig

Änderungen an einem MutexSecurity-Objekt wirken sich erst dann auf die Zugriffsebenen für den benannten Mutex aus, wenn die Mutex.SetAccessControl-Methode aufgerufen wird, um dem benannten Mutex das geänderte Sicherheitsobjekt zuzuweisen.

MutexAccessRule-Objekte sind unveränderlich.  Die Sicherheitseinstellungen für einen Mutex werden geändert, indem mit den Methoden der MutexSecurity-Klasse Regeln hinzugefügt oder entfernt werden. Dabei werden die zugrunde liegenden Zugriffssteuerungseinträge geändert.  

System_CAPS_noteHinweis

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

Im folgenden Codebeispiel werden die Erstellung und die Verwendung 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 erhaltene Regelpaar wird angezeigt.  Anschließend werden dem aktuellen Benutzer im Beispiel neue Rechte gewährt und das Ergebnis wird angezeigt, das die Zusammenführung der neuen Rechte mit der vorhandenen Allow-Regel darstellt.  

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.
        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
 */

Universal Windows Platform
Verfügbar seit 10
.NET Framework
Verfügbar seit 2.0

Öffentliche statische (in Visual Basic freigegebene) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Zurück zum Anfang
Anzeigen:
© 2016 Microsoft