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-Konstruktor: (String, MutexRights, AccessControlType)

 

Veröffentlicht: Oktober 2016

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

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

public MutexAccessRule(
	string identity,
	MutexRights eventRights,
	AccessControlType type
)

Parameter

identity
Type: System.String

Der Name des Benutzers oder der Gruppe gilt die Regel.

eventRights
Type: System.Security.AccessControl.MutexRights

Eine bitweise Kombination von MutexRights Werte, die die Rechte gewährt oder verweigert.

type
Type: System.Security.AccessControl.AccessControlType

Eines der AccessControlType Werte, die angeben, ob die Rechte gewährt oder verweigert werden.

Exception Condition
ArgumentOutOfRangeException

eventRights Gibt einen ungültigen Wert.

- oder -

type Gibt einen ungültigen Wert.

ArgumentNullException

eventRights ist NULL.

ArgumentException

identity ist null.

- oder -

identity ist eine Zeichenfolge der Länge 0 (null).

- oder -

identity ist länger als 512 Zeichen lang sein.

Warten auf eine Mutex (durch Aufrufen der WaitOne, WaitAny oder WaitAll Methode), ein Benutzer benötigt MutexRights.Synchronize Zugriff. Um den Mutex durch Aufrufen von Freigeben der ReleaseMutex Methoden müssen MutexRights.Modify Zugriff.

Dieser Konstruktor entspricht dem Erstellen einer NTAccount -Objekts und durch übergeben identity an die NTAccount.NTAccount(String) Konstruktor und übergeben das neu erstellte NTAccount -Objekt die MutexAccessRule(IdentityReference, MutexRights, AccessControlType) Konstruktor.

Das folgende Codebeispiel veranschaulicht die Verwendung dieses Konstruktors zum Erstellen MutexAccessRule Objekte. Das Beispiel erstellt eine MutexSecurity -Objekt, wird von Regeln und Regeln hinzugefügt, die für den aktuellen Benutzer verschiedene Rechte gewähren und verweigern. Anschließend können Sie neue Rechte für den aktuellen Benutzer und das Ergebnis wird angezeigt, dass der neuen Rechte mit dem vorhandenen zusammengeführt werden Allow Regel.

System_CAPS_noteHinweis

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

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